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A Brief Guide to ~ 
the Appeal of Petit y "e 
_ Computer "m 


PETIT 


This is COMPUTER 


Upper screen 
display program in Edit Mode. 


lower screen 
display the keyboard in Edit Mode. 


What is Petit Computer? 


Petit Computer brings BASIC right up to date 
on your Nintendo DSi and 3DS, reviving the classic 
computer language that introduced many of us to the 
joys of programming in the 1980s. Once you've got to 
grips with the basics of BASIC, you'll be able to create 
images and sounds, and come up with your very own 
programming masterpieces. Petit Computer is available 
as DSiWare and runs on Nintendo DSi, DSi XL and 3DS 
systems. You can purchase DSiWare via the Nintendo 
DSi Shop or the Nintendo eShop (see p.34 for more 
information). 


Nintendo DSi WARE [Petit Computer] 
Platforms Nintendo DSi,“ DSi LL.“ 3DS 

Developer SmileBoom Co.Ltd. 

Release Date July 19, 2012 

Price 800 Points (see p.35 for more information) 


ARAGIC comes to the Nintendo DSi and 3DS! 


aia) (eT) ae PEND 


o004 


Program with the Stylus 


You can create your own programs in Edit Mode using the 
keyboard on the Touch Screen. You can then switch to Run 
Mode to see your program in action. You can even create your 
own games by combining pre-loaded music and sound effects 
with multiple layers of background screens and sprites. 


This mode enables you to enter your program using 
the keyboard displayed on the lower screen. Your 
program can be up to about 520,000 characters in 
length. 


In this mode, you can run programs 
you have created in Edit Mode, as well 
as entering commands directly. 


Save Your Programs and Exchange Them Wirelessly 


For more info, (es 
see page 

You can save the programs and data you create as files on your system's internal memory. You 
can then use local wireless communication and enjoy exchanging programs with other users. 


BASIC is a computer programming 
language first developed for 
educational purposes in 1964 at 
Dartmouth College in the USA. Home 
ARCS , : : computers from the late 1970s 
BRASS CHSS FSU. ( to the 1980s came with BASIC 

: interpreters as standard, and use of 
the programming language became 


4 This image shows a program included Petit Computer includes a command near-universal. 
with the software being loaded. You can allowing you to exchange programs with 
also save your programs. other DSi and SDS users. (Image: Hiroshi 

Kuri) 


For more info, iéS 
see page nn 


There are 13 programs included on Petit Computer, ranging from simple introductions to 


Great Sample Programs are Ready for You to Enjoy 


programming to full games, three of which are shown below. They are all programmed entirely in 
BASIC, so you are free to modify them in any way you choose. 


Racing Game 4A?Pole-Playing Game A Shooting Game 

FILE NAME [GAME1 J FILE NAME [GAME2] FILE NAME [GAME3] 

This is a classic old-school game in which A first-person maze game in which you A game in which you fly through space. 
you avoid other drivers while collecting battle foes and search for treasure chests. blasting enemies. While simple, but it does 


dots. feature end-of-level bosses. 

These cartoon Take a look at the official Petit Computer website! 

characters are here to 

introduce you to this URL : htto://smileboom.com/special/petitcom/ fo BQ 
all-new 21st century 

update of BASIC. Some You can see other users' programs here! 

are more serious- « y 

minded than others... 


Check it out! NOW! 
( oP) 
(wa 


= _. Getting the Most Out of Petit Computer 
| Practical Data-Creation Tool 


eas 
One of the ways Petit Computer differs from the original BASIC is 


the way in which it allows you to build up multi-layered graphic images 
from background screens and character images. You'll find that some 
of the programs included with the software serve as useful tools for 
creating graphic data. Images from three of these programs are shown 


here. Make use of them when you want to create your own program 


using complex graphic images. For more info, Ts Groneedin: 
* The BG screen creation tool and character creation tools [Rxeteiererx2 nna. FILE [GRPED] 
have been updated on ver.1.1 of Petit Computer, available 


since June 16th. This guide refers to the updated versions. 


ARACTER EDIT 


4 Character Editor 48BG Screen Editor 
FILE [CHRED] FILE [SCRED] 


People Behind Petit Computer 


The President Kobayashi 
Speaks 


This highly-original DSiWare title was developed 

by SmileBoom, a software company based in 

Hokkaido in the north of Japan. We spoke to the 

CEO, Takaki Kobayashi, about how this title 

came about. Find out just what he had to say 

to all the Petit Computer programmers out 
there... 


For moh ee 
see page LLIEE: 


A Quick Programming Blast 


The Single-Screen Programming Challenge 


One of the great things about Petit Computer is that you can just pick it up and write your own 
programs whenever you have a free moment. To show how quick and easy it can be, some of the 
staff who worked on this guide came up with programs that fit on a single DS screen (24 lines max). 
The limited space means efficiency is essential. But it's not just technical ability - a single good idea 


For more info, (és 
see page DEH. 


can go a long way. Take a look at some of the results... 


4 A jumping game you can play with a single 4 Touch the lower screen to squash the & 
button. While simple, it makes good use of the sprites. This demonstrates that even a beginner 
sprites included with the software, and even can program a game that makes use of the 
displays your score. Touch Screen. 


In-Depth Programming 


The Epic Program Challenge 


In Part 5 of this guide, we will introduce two longer games. Entering the code may be rather 
time-consuming, but it is worth it in order to learn some more subtle programming techniques. It will 
hopefully inspire you to flex your programming muscles and come up with epic programs of your own. 


SCORE 84a SCORE 20 For more info, (eS 


see page 


TNOVE GQUNERU, OHORU 


Blast incoming foes in this pseudo-3D shooting In this old-fashioned action game, you dig holes 
game. It utilizes the unique capabilities of the DS to trap your enemies before covering them up. 
system with the stylus used to set the target on the 

Touch Screen. 


0001 


so Source of Petit Computer 


Welcome to the root of Petit Computer 


The Dawn of Home Computing 


The 1980s saw the start of a real boom in home computing. Whereas it was once rare to find 
a device more sophisticated than a pocket calculator in the average home, this all changed as 
computers became widely-available. Most computers at the time came with BASIC interpreters 
as standard, and it was perfectly normal for users to make use of programs they had devised 
themselves. As time went on, computers grew more sophisticated and applications became something 
you purchased, rather than programming them yourself. For more info, { 

Petit Computer seeks to build on that legacy, giving BASIC a new lease [Raa OSE 
of life, while retaining its original charm. 


& Turn the Power On, 


& Petit Computer's and it's BASIC... 
Forerunner 


4" [Family Basic] 
(1984/Nintendo). 
A set that taught you 
how to use BASIC 
on a home computer. 
[Family Basic V3] was 
sold in 1985." 


A+Home computers with the MSX BASIC language 
once reigned supreme. The image is taken from 
the MSXPlayer emulator and featured in an edition 
of MSX Magazine published by ASCII in Japan in 
2008. 


& Magazines Contained 
a Wealth of Knowledge > An edition of LOGIN magazine, 


first published in Japan in 1982 by | 
ASCII and by Enterbrain from 2000. 
It introduced readers to the world 
of video games until it ceased 
publication in 2008. The cover 
image is taken from the August | 
1985 edition. 


<@ My Con BASIC Magazine was 
first published in 1982. It featured 
programs created by readers. It ceased Smememets 
publication in 2003. The cover image is ae Sa en 


ut +. sao. ome 
taken from the October 1984 edition. persone iors 
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Stars of BASIC @ 
Mitsuru Sugaya 


Thirty years ago, when | was busy working on the manga series 'Game Center Arashi’, | really .< A 
got into programming in BASIC on my 8-bit computer. My first original software was a program > 7 BA 
that calculated tax returns. | wanted to be able to program wherever | was, so | bought a pocket p34 7‘eE 
computer and | would be using GOTO and GOSUB commands day and night. | owe my ability to EP Ys 
use Java, Perl and Python to that early experience of BASIC. It really is the basis of all other 
programming languages 

Mitsuru Sugaya, who introduced a generation of Japanese programmers 
to BASIC, has been kind enough to create this original illustration for us. The 
program in the background can be found in full on the official Petit Computer 
website. It is actually a port of a tennis game, programmed by a certain 
Notohoho (http://smileboom.com/special/petitcom/pochette-tennis.html). The 
image on the right is taken from the game. 


Petit Computer includes a large amount of pre-loaded graphical data, making it easy to get started 


and create programs full of visual imagery. This data can be modified using the program's graphic 
editing tools. In this section, we will introduce some of this graphical data. Refer to it in conjunction 
with the error code, function and command lists at the back of this guide. 


"| The Console Screen, BG Screens and the Sprite Color Code 


The color display on the console screen, the Color Code> 
background (BG) screens, and for sprites is made up of Ol234S56789ABCODEF 
nae U 
units known as palettes, each comprising an array of 16 » i a ee a 
: : 0) 
colors. Each of these colors is assigned a number, from + Ae 
oO 7 
0-15. This is known as the color code. Please note that Oo 4 
: : Oo 5 
the color code 0 is always assigned to a transparent 2. 6 
display. ? 
an 
9 
In this table, the color codes are written across the top, while the A 
palette numbers are written down the side. The numbers are written B 
in hexadecimal (base 16) form. Cc 
D 
E 
Fm 


rn Graphic Color Codes 


The graphic screen can display color codes numbering 


Colo 

0-255 simultaneously. Please see the adjacent table for 0 

the order assigned to each color. Colors with the code O e oF 
and 16 are transparent. 22 

3 3a 

o 4a 

In this table, the color at the top left (00) has the code O, while the color at g ; a 

the bottom right (FF) has the code 255. ® 7 

‘ om 

3m 

A 

BO 

Cll 

| 

El 

Fa 


By varying the palette number while displaying the same image, you can 
completely change the visual impression, as shown in this image. 


Petit Computer Resources 


Character Codes 


Character codes are the numerical values assigned in the program to different characters. In 


Petit Computer, there are a total of 256 different character codes. 


In the table below, the red numbers on the left are decimal, while the black numbers on the right represent hexadecimal (base 16) code. 
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functions and commands can 


More info on variables, 
be found on page 
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INT 


Seve Re ee Oe 


By using the GRPUTCHR and PRINT commands, 


you can display an assigned character. For 
instance, the character code 6 will display this 


character. 


@ Sprite Characters 


A sprite is a character of a fixed size that is displayed on the screen. For more info, (€S 
see page 074. 


move freely around the screen. Please refer to the section of this guide that starts on page 79 to 


The name 'sprite' comes from the image of a fairy-like creature that can 


learn more about how to use sprites. 
In Petit Computer, there are separate selections of sprites available for use on the upper and 
lower screens. 


" Sprite Characters (Upper Screen) 


There are a total of 512 different sprites available for display on the upper screen. For ease of 
use, these are divided into different sets of 64 sprites, each of which is assigned a code SPUO~7. 
These sprite sets are known as banks. 
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’ Sprite Characters (Lower Screen) 


There are a total of 118 different sprites available for display on the upper screen. The code 


SPSO is assigned to this bank of sprites. 
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Up to 100 sprites can be displayed 
simultaneously. As can be seen from 
this image, each individual sprite can be 
moved around the screen, in addition to 
being rotated, expanded or shrunk. 


There are 64 different user-interface icons which can 
be displayed on the lower screen. These allow users to 
select different options, depending on the nature of the 


Petit Computer Resources 


Background Screen Characters 


It refers to functions relating to 


The background screen is abbreviated to the BG screen. 


background-screen image display. In Petit Computer, there are 4 banks of graphic characters (BGUO- 


3) assigned to the BG screen. 
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* The example image 


uses palette 8. 
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An Example of the BG Screen Display Function 


By creating a background image using both BG screens and positioning a sprite, 
you can create a classic scene from an RPG. By using images of tree trunks on 
the rear BG screen, and overlaying another screen with leaves on it. it allows the 
hero's sprite to conceal itself among the trees. 


BGU3 


%* The example image 
uses palette 10. 
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So Just What is Petit Computer? 


Many of you reading this strategy guide will no doubt 
have experienced the BASIC boom of the 1980s at first 
hand. Before we turn to Petit Computer, let's cast our 
minds back to those heady days and take a whirlwind 
tour of the history of this classic programming language. 
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Your Guides to the World of Petit Computer 


6s N Professor Jones 
OOHy Although he looks dry and dull, he was 
passionate about BASIC in his youth and 


is prone to reminiscing at length about the 
good old days. 


4 Nigel 
A serious-minded young man, he looks at 
programming from a technical perspective 
and loves to explain complex issues in 


clear terms. 


Johnny 

(7.0 A rough-spoken character, he 
doesn't like to mince his words. 
But give him a chance and 


you'll find he's not such a bad 
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guy. 
Billy 


A regular run-of-the-mill fellow 
who just wants to learn more 
about BASIC. 
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PARTi1 So Just What is Petit Computer? 


i2ma5 Meet the People Behind Petit Computer 


So how did Petit Computer come about in the first place? What kind of people created it? Was 
it a labor of love, made by people who experienced the original BASIC boom? We spoke to Takaki 
Kobayashi, the CEO of SmileBoom, the Sapporo-based development studio who are behind Petit 
Computer. Here's what we discovered... 


Before we get started on the main topic of discussion, let's go back a little (okay, a lot...) and talk 
about how Kobayashi got started in the industry. 

Born in the city of Yubari in Hokkaido in the north of Japan, Kobayashi grew up in an area famed 
for its fossils. 

‘There was a fossil club at elementary school, and | used to really love collecting them.’ But the 
young Kobayashi's thoughts turned from the past to the future when the home computing boom 
began during his time at junior high school. He would write programs together with his friends on an 
NEC PC-8001, a computer with a PCG-series board released in 1970. When he was a senior high 
school student, he got hold of a Casio computer, the FP-1100, released in 1982. With the hardware 
being so slow, it gave him the opportunity to learn machine code, and he says that he found it easy to 


express fun things using computers. 


= January 2008, he left this company to set up 
Smileboom, where he is now CEO. 
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Interview: Takuya Matsubara (Writer and contributo: wi 
Magagine. Worked on Petit Computer for 3 months) S 
Photographs: Toshiyuki K@frabane a . 
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After graduating from high school, Kobayashi joined DB Software, a company based in Sapporo. 
This was in 1985 when the 8-bit home computing boom was in full swing. 

‘| actually wanted to go on to university, but having worked on titles like Flappy, | saw that there 
was a job opportunity in Sapporo. | did an interview, and ended up being hired.’ 

After joining the company, Kobayashi worked on planning and developing the title 'Woody Poko’. 
He subsequently worked on games including 'Konyamo Asamade Powerful Mahjang' and 'Melloon’. ‘I 
was really amazed that the company gave me the opportunity to work on titles like this, even though 
| was a new member of the team.’ At the time, DB Software was a company that really liked to create 
its own development tools and tailor-make DOS programs. 


5) 
FO UZ) 


4 'Uddipoko' (DB Software, 1986). An action-adventure game with 4 'Konyamo Asamade Powerful Mahjang' (DB 
number of innovative features, including the way time passes, and Software, 1988). A huge mahjong game with four 
the use of the left and right hand in the game. Kobayashi worked different modes. The title display changed with 
as designer and programmer for the title. The image is taken from the seasons. Kobayashi worked as designer and 
the Windows version of the game, and features in a Japanese programmer for the title. The image comes from 
publication looking at the classic PC-8801. the X1 turbo version. 


In 1990, Kobayashi set up Ajenda Co. along with five other former colleagues from DB Software. 
The company president was Mr Fumiya Matsui. For those who are interested, an interview with Mr 
Matsui and Mr Kobayashi about their time at dB-SOFT is included in a book on PC-8801 classics 
released in Japan. 


During his time at Ajenda Co., Kobayashi's focus shifted to games for home consoles and mobile 
gaming. It would be impossible to discuss all the games he worked on here, but one title worth taking 
a closer look at was 'Studio P’, a title released for PlayStation in Japan. This title was a compilation 
of a number of different tools, with intriguing functions such as one that let you make pots and fire 
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them in a kiln, or use a special controller called the ‘Studio P’ to wring out a computer-generated 
cloth. This was a title where Kobayashi really gave free rein to his individual take on video game 
technology. 'Well, it's really fun to use new technology in a way that no one would normally think 
of.’ The software included a sequencer and a graphic editor, meaning that it served as a kind of 
forerunner for Petit Computer. 


> 'Studio P' (1996/Ajenda Co.) 

Studio P was a dream come true for anyone who wanted to unleash their creativity, 
featuring everything from 3D animation tools. to sequencers, to paint tools.It included 
unique ideas, such as letting users make their own pots and fire them in a kiln, or 
use the special neGcon controller to wring out a wet cloth. It was released for the 
PlayStation in Japan. 


© AGENDA Co., Ltd. 


Kobayashi describes how this title brought him to the attention of SCE(Sony Computer 
Entertainment), who saw that he was creating consistently inventive titles, and they worked together 
on the cooking-action game ‘Ore no Ryori', as well as the board-game themed titles 'Gacharoku' and 
'Gacharoku2". 

‘Ore no Ryori' was a game that let you experience the fun of cooking using the left and right 
analog sticks. It was an inventive game with features that included chasing cockroaches out of the 
kitchen, and catching customers who try to run away without paying. The game is currently available 
in Japan for PS3, via the PlayStation Network. 'Gacharoku' is a party game in which players can 
compete simultaneously, rather than taking it in turns. It was released for PlayStation2 in Japan. A 
sequel in which the action takes place on a larger scale was released the following year.These two 
titles amply demonstrated that SmileBoom was a company with its own individual philosophy, and that 
its staff liked to do things others would never think of. 

And that's without even mentioning the ‘Tkool’ series, released by Askii and Enterbrain. Kobayashi 
was involved in making four 'Tkool' titles between 1998 and 2008, including ‘Character Tkool 95’. 

Then in 2005, he oversaw the development of 'Daredemo Asobi Taizen' for Nintendo DS. At this 
point, Kobayashi set his sights on creating a game-creation tool that anyone could use, spurred on by 
the unflagging desire to create something original and fresh. 


Agenda created a series of game-creation tools, known as the TKool 
series in English. These included Character Tkool 95 and Shooting TKool 
95 which both came out in 1998 in Japan. Other titles are 'RPG Tkool'. 
released in 2000, and 'Music Tkook DX', released in 2008. This image is 


ORES OPES taken from Enterbrain's official Japanese website at htto://tkool.jp/ 
a eee These old TKool titles are taken from the 'Tkook Museum' link on the site. 
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In 2008, Kobayashi went his own way, and became CEO of his own company, SmileBoom. 

While continuing to design and develop games, he also appeared as a speaker at the CEDEC 
2008 conference for game developers. Asked whether or not he was going to be making more TKool 
software, Kobayashi responded by planning and developing 'Action Game Tkool’. 

An ambitious piece of software, it followed in the footsteps of an earlier title, ‘Shooting Game 
Tkool', and used newly-developed XNA tools. Its intention was to make games easier to create,and 
apparently there are games available on Xbox LIVE which were developed using it. 


Gwarsaae TRE AAG Seo) LSS 


D8" DOr 


eA RUTH ~LEORNERRISATS 
“Emon (Bh yaar 


ane. ARE ZNAO-E. 


ig al al 


(aa (a) 


> ‘Action Game Tkool' (Enterbrain, 2009). The latest Tkool Series title let 
the user create a series of action games, including shooting games. It was 
notable for making use of XNA tools, meaning that games created using it were 
compatible with the Xbox 360. This software could be run on Windows XP and 
Vista. 

The official Japanese site is http://tkool.jp/products/act/top.html 


IMEI A °B sitet 


For Kobayashi, the desire to create Petit Computer was born out of his own very personal vision, 
as opposed to the general direction of the company as a whole. A major influence on his desire to 
create this game was 'dB-BASIC’, developed by DB Software. 

‘Back then, Hudson had developed Hu-BASIC, and there was also 'Family BASIC’. It felt like any 
company developing games needed its own version of BASIC. I'd always wanted to come up with my 


<4 BASIC developed by DB Software. The image is 
taken from an integer calculation program. version 
X1 on dB-IBASIC. 
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own version, and that dream has finally come true.' 

The planning process began with Kobayashi coming up with his own pixel images of the onscreen 
keyboard, taking them to Nintendo in Kyoto and asking how he should proceed. Various plans were 
proposed initially, such as using the Wii to program the software, and then transferring it to DSi, or 
using an FAT file allocation system. Over the course of numerous meetings, adjustments were made 
to the plans for how to proceed. 


> The Sharp 'MZ-80B', a machine that Kobayashi 
admires. He says that if development on it had 
continued, it may have ended up resembling Petit 
Computer. 


A crucial issue raised at the earliest stages of planning Petit Computer was that it shouldn't be 
seen as a means of analyzing or modifying other games and software. From a security point of view, 
SmileBoom made sure there were no PEEK or POKE commands that could be used to save or load 
data to the memory, and they prevented user-created programs being downloaded to PCs. 

When asked why he decided to develop Petit Computer for the DSi, Kobayashi responded as 
follows: 

‘We wanted to make this into a title that people would pick up and try for themselves. As a small 
company, creating the software as DSiWare meant that we avoided large overheads, and it was 
really easy to bring it to the market. At the time, 
the DSi was the only platform that we thought 
would suit our needs, and in July 2010, we had 
finalized the design for Petit Computer. It was 
actually released towards the end of 2010, so it 
took about three month to complete it. 

The development for the Petit Computer 
software itself was overseen by a pair of young 
developers from a company called 'Rocket Studio’, 
based in Sapporo. Takebe, the president of Rocket 
Studio, regularly met with Kobayashi, and it was 


1-1 Meet the People Behind Petit Computer 


Welcome to Smileboom 


SmileBoom is a company based in Sapporo in 


Hokkaido, in the north of Japan. It defines its goals 


as a company as the development of fun games and 


accessible tools, in addition to consulting, and creating 


quality online content. Its titles include 'Petit Computer’ 


and 'Action Game Tkool'. 


action @ 


4 Xbox LIVE Indie Games: 'First 
Aid'(2009) 

This Japanese release teaches people 
how to use an AED, and perform mouth-to- 
mouth resuscitation and heart massage. It 
is popular amongst elderly users. 


4 Space Milkman(2009) 

This side-scrolling platform game was 
developed using SmileBoom's ‘Action 
Game Tkool'. 


SCORE 0050400 HIGH SCORE 0383800 


4 Xbox LIVE Indie Games: '8D °° (infinity)! 
A shooting game with a 3D display. Even 
if you don't have a 3D television, it can 
still be enjoyed using 3D glasses. 


Let's meet the other members of the SmileBoom team. The member of staff responsible 


for single-handedly entering the vast amount of character data required for Petit Computer 


is called Goto. When Petit Computer was being put together,it was decided that original role- 


playing, shooting and action games should be included.It was also determined that there should 


be games with both side-scrolling and top-down perspectives, as well as games with and without 


gravity. Hosoda was responsible for the optimization of the programs. This made the software's 


processing speed faster. 


The official Petit Computer website was designed by Ueno. His love for computer and video 


game magazines really comes across in the playful way he designed the site. Kobayashi was in 


charge of creating the sample programs included on Petit Computer. He actually used algorithms 


he had developed years previously for the high-soeed PAINT command. 


Hosoda in Smileboom.He's known as 
'the Captain’ at work. Was in charge 
of the fine-tuning of Petit Computer 
programs. 


> Ueno in Smileboom.He oversaw 
design of the official Petit Computer | 


website. 
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during one of these meetings that the plan to collaborate on this software was hatched. Takabe is 
a well-known software developer who once worked for Hudson, and worked on the development of 
‘Family Basic’. 

The music for Petit Computer was created by a small team from a company called 'JOEDOWN'. 
Early in development, the team had to abandon the MML replay function they had planned to 
implement. But by adding options to control the tone and pitch of the short sounds created using 
the BEEP command, they managed to create a rich variety of audio content for Petit Computer. 
Kobayashi's idea was the music should recall the sound of the SCC (sonic custom chip), which would 
strike a chord with anyone who can remember the classic home computing era. The background 
music was composed with this in mind, and the team are very proud of what they have managed to 
achieve. 


Rocket Studio, Inc. JOEDOWN 


Rocket Studio, Inc} 


4A software development team from in Sapporo, Hokkaido. They 4A music production company from Sapporo, 


have been involved in a large number of games for handheld Hokkaido. They have scored a large number of 
devices and mobile phones. Though it is a long-established TV programs, commercials and video games. They 
company with many experienced employees, younger team were responsible for all music and sound effects 
members oversaw the programming of Petit Computer. for Petit Computer. 


During the development process, there was a great deal of discussion amongst the team about 
the BASIC functions that should be included on Petit Computer. For instance, a number of functions 
were revised in September 2010, including the = sign used for IF commands, and the LINE ( x, y ) 
format. The team also agreed that IF and ELSE commands extending over multiple lines would make 
programs hard to read, and so this function was removed. 

While it is a little unusual, the ? symbol can be used to stand in for the PRINT command. This was 
a feature used in the development process that the team intended to remove, but which somehow 
managed to make it into the final version. 

In the planning stages, the intention was that the character creation tool and other functions like 
this would be fully integrated into the software, and selected using the buttons. However, to reduce 
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the development workload, someone had the bright idea of actually programming these tools in 
BASIC. There were also quick commands used, including GPUTCHR which displays character data 
on the graphic screen, and GFILL which fills a rectangle with one color. 


Petit Computer was finally released as DSiWare in Japan in March 2011, for a price of 800 
Nintendo DSi Points. According to Kobayashi, this software functions as a promotional tool, showing 
what the company is capable of, which explains why it is so reasonably priced. 

‘With the way things are in the industry, the only way to survive is to keep coming up with good 
ideas. You have to do things other companies aren't doing. You know whether or not you've got a 
winner at the planning stage.’ 

The response to Petit Computer was even more positive than the developers had hoped for. 
When users were asked to contribute their own programs, people would turn up at the Smileboom 
office, with their DSi in hand. There were also users who sent in programs of incredible length and 
complexity. SmileBoom even received mails from people telling them that they had bought a DSi XL 
simply in order to use Petit Computer. The software was initially targeted at users in their 40s, but 
now Kobayashi wants to give younger people a taste of the joys of programming. 

Asked about Smileboom's future ambitions, Kobayashi speaks about his desire to contribute to 
Hokkaido and make it a better place. He wants his company to explore IT solutions that can be used 
to improve agriculture and fishing, and strengthen the industrial base of the region. This is a grand 
vision that goes far beyond the traditional goals of game developers. Petit Computer also looks like it 
has a bright future ahead of it, and it will be exciting to see how it develops. 

To conclude the interview, Kobayashi wanted to share the following words with the readers: 

‘lf those in my generation do not live our lives to the full, how can we expect the younger 
generation to grow up to fulfill their dreams? y 
This is the time when we need to give it all 
we've got. Let's try all sorts of things, team 
up with each other, and do all sorts of crazy 
stuff!" 

(April 201 1) 
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The Heyday of BASIC 


Reading over the interview with the CEO of SmileBoom, it is clear that there is an incredibly 
strong link between Petit Computer and BASIC culture at the height of the home programming boom. 
Now, in order to help you get the most out of Petit Computer, let's take a look at the history of home 
computing and BASIC. It's a huge topic, so we'll just take a tour of the most important points. 


In 1976, NEC released the TK-80 home computer assembly kit. It really wasn't much more than 
a stripped-down circuit board, but it was a huge hit. The first Japanese home computer boom had 
begun. In the wake of this, Japanese consumer electronics companies competed to bring out home 


computers. Here is a list of some of the main ones... 


PC-880 1(1979/NEC), BASIC MASTER LEVEL3(1980/HITACHI), 
MZ-80B(1981/SHARP), PC-6001(1981/NEC), FM-7(1982/Fujitsu), 
X1(1982/SHARP), PC-8801(1981/NEC), PC-9801(1982/NEC) 


..etc. etc. By 1984, there were over 50 types of computer on the market, all vying for supremacy. 

With this era of computers, it was assumed that users would be able to program, and BASIC 
came as standard on almost all models. BASIC was a programming language that had originally 
been created in 1964 for educational purposes at Dartmouth College in the United States. It was 
developed into what is Known as an interpreter (a function that translates and runs commands), and 
was adopted worldwide. The features of BASIC varied depending on the model of computer, and 
porting programs between models could be extremely time-consuming. 

As an attempt to create a universal programming language, Microsoft and the ASCII Corporation 
collaborated and released MSX in 1983. Computer manufacturer all released their own models that 
used MSX, and it came to occupy a dominant place in the Japanese market. 


| <PC-6001mkil'(1983/NEC) 

| A computer that appeared right in the middle of the boom. It achieved fame for 
its 16-color display, speech synthesis capability, and high price tag. Its CPU was 
| compatible with the Z80, and it had a 64 kilobyte RAM and VRAM capacity. 
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1982 was the peak of the computer magazine boom in Japan. This period saw a shift 
from the four main magazines (‘Monthly Micon'(Denpa Shinbunsha),'l/O'(Kogakusha),'Monthly 
Ascii'(Ascii),,RAM'(Kosaido)) to new magazines aimed at a younger readership." These magazines 
included 'Micon BASIC Magazine’, fondly known as 'Be Maga’, the more entertainment-oriented ‘Login’, 
and 'PIO' which was spun out of 'I/O'. 

At the heart of these magazines were the type-in computer programs. Computer enthusiasts, keen 
on saving money by making full use of these programs, put their heads down and entered this code 
in full. These programs were usually written in hexadecimal machine code, as the priority was to 
keep the processing speed quick. Naturally, the main way in which data was stored at the time was 
on cassette. Every old-school computer enthusiast can remember the seemingly-endless screeching 
sound of those tapes as the data loaded. 
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illustration : Hiroshi Kuri 


Stars of BASIC @ > 'PC Lecture! was published for an 
impressive 17 years. (Micon BASIC 


Hiroshi Kuri Magazine From Feb 1986) 


The earliest incarnation of BASIC had a very restricted memory available 
for programming, with an 18-digit, 1680 step limit. Yet still, | was able to create 
several games of my own. 

When making a number of games on the PC for 'BASIC Magazine’, | tried to replicate the sound that plays 
at the beginning of a stage in 'Dragon Buster' using the BEEP command, but sadly it didn't sound anything 
like it... Perhaps | was subconsciously trying to avoid being sued for copyright infringement... With Petit 
Computer, there are a lot more sound effects, so | get the feeling that you could use this version of BASIC to 
make a pretty fun music game. 


© dempa 


Hiroshi Kuri is a manga artist and illustrator whose primary theme is computer technology. He created the long- 
running 'PC Lecture' series, which first appeared in 'Micon BASIC Magazine’ in 1985. He is an extremely well-known 
figure among the BASIC generation in Japan. 
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In some ways, the forerunner of Petit Computer was Family Basic, which was released by 
Nintendo in 1984 (the third version of the software was released the following year). Family BASIC 
came with a cassette machine and keyboard which connected to the Famicom, allowing BASIC to be 
run on it. The main drawback was the restricted RAM. 

Many other companies had experimented with BASIC on cassette format, including 'M5'(Sword/ 
Treasure), but it was with the arrival of 'Family Basic' when programming on home consoles really 
came of age. There are plenty of subsequent examples of BASIC being brought out for home 
consoles. 

For instance, Epoch released software designed as an introduction to BASIC for its Super 
Cassette Vision console in 1986. In 1996, the game development tools the Debero Box and Debero 
Starter Kit were released for the PC Engine in Japan by Tokuma Shoten. In 1998, ASCII released 
Game BASIC for Sega Saturn, and Art Dink released BASIC Studio Powerful Game Workshop in 2001 
for the PlayStation 2. Bringing BASIC to home consoles is a project that has always appealed to 
developers. 


The most well-known version of BASIC in Japan is probably 'N88-BASIC'. N88-BASIC' began on 
the PC-8801, before becoming widely-used on the PC-9801 in the N88-BASIC (86) version. There 
were many different versions, including DISKBASIC, the ROM version of which was launched when 
the power was turned on, and the MS-DOS version. Some degree of compatibility was maintained 
between them, which was greatly appreciated by users. N88-BASIC (86) had real staying power, and 
its ROM version was included on the PC-9821 series released in 1996. This means that although 
Windows 95 may have been running on the surface, beneath this was a dormant BASIC. 

N88-BASIC finally reached the end of its life with the release of the PC98-NX series in 1997, 
which was PC/AT compatible. While Windows has become the norm nowadays, the DNA of BASIC is 
retained in software such as Microsoft Visual BASIC and N88 BASIC freeware. 


At the start of the 1980s, the market for computer software expanded enormously, in response 
to global demand. Programming contests were held offering huge cash prizes, and the popularity of 
computer magazines spurred on professional and amateur programmers alike to achieve great things. 


1-2 The Heyday of BASIC 


Computer users were interested above all else in games, which at this time were limited to action 


and puzzle games. But as home computing developed, so too did the range of gaming genres. This is 


the period when adventure games, simulations and role-playing games arrived on the scene. 


By the mid-80s, floppy disks were widely used to store data, allowing games on a much grander 


scale, as well as word processing and calculation software. At this time, users' attitudes towards 


software shifted, and writing your own programs became a minority pursuit. From this point on, BASIC 


steadily declined in popularity. 
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4'Omotesando Adventure'(1982/Ascii) 
This has a strong claim to be first 
Japanese text-based adventure game. 
The in-game language was English. The 
image is taken from a Windows version 
running on a 8001 emulator, which 
featured in a publication about the 
classic PC-9801. 


4 The Black Onix'(1984/BPS) 

This celebrated RPG put you in the 
depths of a dark and dangerous 
dungeon. Making your own map was 
essential to in the final stages. This image 
is taken from a Windows version running 
on a 8001 emulator, which featured in a 
book about the classic PC-8801. 


For computer hobbyists in the 1980s, the top priority was 
graphical capability. The Fujitsu FM-77AV, released in 1985, 
offered 4096 color display, but Sharp struck back in 1987 with 
the X68000, which boasted 65,536 colors. The X68000 came 
packaged with the arcade hit Gradius, and at the time represented 
the ultimate in home computing. Fujitsu responded with the FM- 
TOWNS in 1989, which featured a built-in CD-ROM drive. At the 
same time, video games designed for business machines such 
as the PC-9801 began to appear, and became a fixture of the 
computing market. 

By the mid 1990s, a new generation of home consoles had 
been released. PCs could not compete with these consoles in terms 
of price and graphical capability. Consoles seized the initiative with 


ures 


A This classic publication successfully 
captured the appeal of video games. It was 
written by Akira Yamashita and published 
in 1985 by Dempa Shinbunsha. It has been 
reprinted, along with its sequel about role- 
playing and adventure games. 


© dempa 


the X68000. A convertor which was sold 
separately converted code into the C 
programming language, putting it at the 
cutting edge of BASIC technology. The image 
is taken from the EX68 X68000 emulator. 


the flagship RPGs that had once been the preserve of home computers, and the PC gaming market 


began to decline. Petit Computer aims to revive the spirit of that golden period when hobbyists would 


really make computers their own. 
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PAFRT1 So Just What is Petit Computer? 


ASCII published a series called 'Yomigaeru Densetsu’ (‘Legends Reborn’). These captured the spirit 


and passion of the golden age of home computing. Packed full of features, including interviews with 


the major figures of the day, as well as CD-ROMs of classic titles, these publications were embraced 


by fans of vintage home computing. In addition to the editions featured below, we heartily recommend 
the 2005 edition featuring the NEC 8-bit PC-8001 and PC-6001. 

The MSX Magazine collectors’ edition from 2002 is also a classic. The second edition was 
released in 2008, while the third edition came out in 2005. 
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Stars of BASIC @ 
Kiyokazu Arai 


Legends Reborn - PC-8801 Collectors' 
Edition was published in 2006. It came with 
a CD-ROM that contained 13 famous titles, 
including 'The Black Onix','Hide Lide' 'Woody 
Poko. 


>» "Legends Reborn - PC-9801 Collectors’ 
Edition was published in 2004. Including 
‘Mugen No Shinzo 3' 'Sylpheed' 'Omotesando 
Adventure’ The second edition was released 
in 2007." 


>» "From 'Login'(Ascii) 


'Mashingoshin Kondo' 


square." 


| was responsible for the layout of the computer magazine LOGIN in the 
mid 1980s. Originally, | drew manga, and when someone asked me to draw 
a comic strip, | came up with 'BASIC-kun'. He was of course a BASIC-themed 
character, and his rival was Princess Mashinko Kondo. Her clothes were 
covered in machine code. | think that nowadays, clothes with programming 
languages like BASIC written on them might actually be quite a hit. | hope 
someone follows up on that and actually makes them. 


Kiyokazu Arai is the artist responsible for BASIC-kun, a popular cartoon familiar to everyone 
who was part of the BASIC generation in Japan. It first appeared in LOGIN (ASCII) in July 
1984. It subsequently appeared in Famitsu (ASCIl/Enterbrain), and MSX Magazine (ASCII). 
‘Grown-Up BASIC-kun' now appears in Otona Famitsu magazine (‘Famitsu for Grown-Ups’). 
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Getting to Grips with 
Petit Computer 
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In this chapter, we give an introduction to Petit 
Computer, offering a basic overview of its functions for 
people who have not yet used the software. By studying 
the sample programs, beginners will be able to get an 
idea of the possibilities that Petit Computer will put at 


a 


, their fingertips. 
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With Petit Computer, 
I've finally got the 
programming tools I've 
been dreaming of! 


At first, how to get 

hold of Petit Computer ' » 
Come on! Enough 

C 1 4) talk! Let's try out Petit 
Computer! 
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PART2 Getting to Grips with Petit Computer 


“ainee What is Petit Computer? 


So what exactly is Petit Computer? Anyone who can remember the days when BASIC was all 
the rage will probably already have a good idea. But before we give the real thing a go, here is an 
introduction to this software. To put it simply, Petit Computer is a unique combination of new and old 
which puts the classic home computers of the BASIC programming era in the palm of your hands. 


Petit Computer is a DSiWare program that revives the classic BASIC language that was once 
synonymous with computer programming. For those of us who remember those days from their 
youth, computers were very expensive and out of reach of most people. Now, three decades later, 
BASIC has been revived on the Nintendo DSi and 3DS systems, making this programming language 
accessible to everyone, young and old. 

As the name suggests, Petit Computer gives you a compact home computer in the palm of your 
hands. 

The dual screens of your Nintendo DSi or 3DS system will become the screens of a classic home 
computer from the BASIC era. The upper screen displays the program list, and functions as the 
display when your program is run, all in the 8-bit characters familiar from that time. The lower screen 
features the keyboard display, allowing you to use the intuitive Touch Screen interface to input all 
kinds of commands. It is just like using a miniature version of the PC-8001 or MSX. Although you 
cannot save the programs you create to an external drive, you can exchange programs via local 
wireless communication with other users who have Petit Computer installed on their Nintendo DSi or 
SDS systems. 

Petit Computer uses its own unique version of the BASIC programming language. It does not differ 
greatly from the original BASIC language, but features a number of new commands tailored to the 
functionality of the Nintendo DSi and 3DS systems. These new commands cover a large number of 
operations, including sprite and background display manipulation, audio and panel components used 
for input. 

Petit Computer also includes 13 sample programs, a huge amount of sample graphic data allowing 
the display of thousands of different characters, and over 100 varieties of audio data. By making use 
of this wealth of resources, you can experience the true thrill of computer programming. 


2-1 What is Petit Computer? 
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Petit Computer is designed for use with the Nintendo 


DSi, DSi XL, and 8DS systems. The screen size differs on 
each of these systems, allowing you to choose the system 


that best suits you. 


Transfer from Nintendo DSi to Nintendo 3DS 


By using the Data Transfer tool for the Nintendo DSi, which you can 
download free from the Nintendo DSi Shop, you can transfer Petit 


Computer from your DSi or DSi XL to your 3DS.Please note that you cannot 


transfer Petit Computer purchased on a 3DS to a DSi, and that all save : : ; 
data will be lost when transferring the software. 4 (from left to right) Nintendo DSi, 


DSi XL, and 3DS 


Nintendo Dsi XL 
tam, 4,.2-inch display (approx. 85x64mm) 
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composed by JOED, Ed. Nintendo DSi 
e dy Dut eau dam 3.25-inch display 
aia gee (approx. 66x49mm) 


Actual Size Display on 


Different Systems 

The image on the left shows the difference in screen 
sizes between the Nintendo DSi and DSi XL systems. 
A bigger display is probably better for the input 
screen for BASIC.For the purposes of using Petit 
Computer, the DSi XL is recommended. 


Al 


we =. 
In, Nintendo 3DS 


Actual Size Display on Nintendo 3DS 
Upper screen Pep ap ; 
: a ‘a When running Petit Computer on the Nintendo 3DS. the 
3.53-inch display (approx. 77X46.1 j sides of the upper and lower screens will be black.This is 
Lower screen , due to the different scaling of the 3DS when compared to 
3.02-inch display(approx. 61.5X46.1 mm) the DSi. The resolution is also different, meaning that the 
oak enlarged display can make the pixels look a little indistinct. 
A good tip to switch off this zooming function is to start the 
8DS while holding SELECT. This allows you to view Petit 
Computer in the original resolution. 
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Getting Hold of Petit Computer 


If you have never purchased DSiWare before, or are not familiar with how the Nintendo DSi 
works, we hope this guide will prove useful. Needless to say, the Nintendo DSi and 3DS are very 
user-friendly.However, as Petit Computer is not available in the shops, you may require some 
assistance when purchasing and downloading it directly to your Nintendo DSi or 3DS. 

Here are the simple steps to follow in order to get hold of Petit Computer. 

The two absolute essentials are an internet connection and DSi Points. 

For those readers familiar with the DSi or 3DS and who knows how to purchase DSiWare, feel 
free to skip this section. (Please note that all images are of the Nintendo DSi/DSi XL interface, though 
the interface for the 3DS is almost identical.) 


In order to download Petit Computer to your Nintendo DSi or 3DS, the first thing you'll need to 
do is connect to the internet. Petit Computer is available for purchase from the Nintendo DSi Shop, 
or from the Nintendo eShop for 3DS users. Connect to the internet using your home wireless LAN 
router, or use a special wireless LAN adapter plugged into a computer which is online. If you do not 
have access to the internet, you may need to contact an internet service provider to find out more 
about your options. 

Once you have enabled a wireless LAN environment, you will need to connect the DSi to the 
wireless LAN router. To connect your DSi to the internet, first access System Settings on the DSi 
Menu. Select the Internet option and then select the settings required to connect to the internet 
access point. See the screenshots below for a clearer idea of the steps in the process. 


4YI-RYE 
—_———— OO 
a | 
oz DSiIxm=A—AN 
4 Touch 'System Settings’ on the DSi AScroll over to the third page and touch 4 Now choose ‘Connection Settings' to 
lenu. the 'Internet' option. enter the wireless LAN settings. From 


this point on, the procedure is the same 
as when you connect any device to a 
wireless connection. 


%* The procedure shown above is for the DSi or DSi XL. When using a SDS, first access the Nintendo eShop from the menu before following the steps 
above. Please note that if 'Nintendo eShop' does not appear on your 8DS main menu, you will need to perform a system update. To do this, connect to the 
internet and select 'System Settings’ from the main menu. Select 'Other Settings’ followed by ‘System Update’. 


2-H2 Getting Hold of Petit Computer 


Another option is to make use of a DS Download 
. . : You can find out more information here. 
Station. These allow users without an internet Check out the official website for a handy guide to DsiWare. 
connection to access the DSi Shop and download htto://www.nintendo.co.jp/ds/dsiware/howto.html 


Petit Computer. 


Once you have established an internet connection, follow the steps below to purchase Petit 
Computer. 

Touch ‘Nintendo DSi Shop' on the DSi menu. Next, touch 'Start Shopping’. If you cannot access the 
DSi Shop, check your internet connection and try again. 


=YFTYF—-DSivVavT 
Nintendo 


4 Touch the 'Nintendo DSi Shop' icon on the DSi Alf it does not connect, select 'System Settings! 
menu. and then ‘Wireless Communications' to check that 
it is not set to ‘Off. 


Once you have connected to the internet, you will be able to access the Nintendo DSi Shop and 
purchase Petit Computer. But before you do that, you need to ensure you have sufficient DSi Points. 
Nintendo DSi points are a kind of virtual currency required to purchase DSiWare. You can obtain 
Nintendo DSi Points in the following ways: 


- Purchase a Nintendo DSi Points Card at a local retailer or online. 

- Access the Nintendo web site via your cell phone (NTT Docomo/au) and purchase a Nintendo 
Prepaid Code. 

- Use a credit card to purchase DSi Points directly from the Nintendo DSi Shop by selecting 'Add 
Points’. 
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PART2 Getting to Grips with Petit Computer 


Normally, the minimum number of points you can purchase is 1000 (if you are using a Nintendo 


3DS, you can purchase 500 points from the Nintendo eShop). 


Now that you have a supply of DSi Points, you are finally ready to purchase Petit Computer. 


Touch the 'Nintendo DSi Shop' icon on the DSi menu. Next, touch 'Start Shopping’. If you cannot 


access the DSi Shop, check your internet connection and try again. Once you have accessed the 


main DSi Shop page, touch 'Add Points’. 


DS® Ware. 
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A Touch 'Add Points' on the main page. 


4 You can then choose between 
redeeming a pre-purchased Nintendo DSi 
Points Card, or paying with your credit 
card. 


a Nintendo DSi Point Cards can be 
purchased from retailers of Nintendo 
goods. After scratching off the silver area 
on the back, enter the unique number on 
the card. 


As an example, we have purchased a Nintendo DSi Points Card with 1000 DSi Points. Scratch off 


the silver area on the back of the card to reveal a number. Select 'Redeem Nintendo Points Card' and 


enter this number. 


Once you have entered the number and received the DSi Points, the card can be discarded. 


When you add DSi Points, a screen like the one shown below will be displayed. This shows your 


current DSi Point total. Touch 'OK' to return to the main page. 
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4 Your DSi Points have been added. 


Petit Computer costs 800 DSi 
Points, so adding 1000 DSi Points 
will more than suffice! You will have 
200 DSi Points left over. 
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Now that you've added DSi Points, you'll be able to purchase Petit Computer and other DSiWare. 


There are a huge number of titles available from the DSi Shop, so you will need to find Petit 
Computer. That's where the search function comes in. Touch the 'DSiWare' panel at the top of the 
main page. 

Touch 'Find Titles' then 'Search by Software Title’. Use the onscreen keyboard to enter 'Petit 
Computer’. Finally, touch 'OK' to commence the search for DSiWare with this title. 
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4 Return to the main page and touch 4 Touch 'Search by Software Title’. 4 Touch the onscreen keyboard to enter 
‘DSiWare’. ‘Petit Computer’. 


The search results screen should display 'Petit Computer' and 'SmileBoom'. Touch this to proceed. 


(Pit? 
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4 Once Petit Computer has been located, touch the icon to 


proceed. 
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Now you're all set to download Petit Computer. 

Tap the 'Download' icon on the screen and there will be a message requesting confirmation. 
Touch 'Yes' to begin the download. 800 DSi Points will be subtracted from your total. Wait while 
the software is downloaded and saved to the system memory. Petit Computer required 117 blocks. 
Blocks refer to the amount of memory a title requires. You can install software to a total of 1024 
blocks of memory. 
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4A Touch the 'Download' panel. 4 When the download begins, the DSi Points and blocks of 
memory you have remaining will be displayed. 


Go back to the Nintendo DSi Menu, and you will find a new icon that looks like a wrapped present. 
Touch this icon and Petit Computer will appear. 

You have now successfully purchased Petit Computer. Touch the icon and let the programming 
fun commence! 


Bes pel 
SmileBoom 


Listen up! Put your version of Petit 


¢ GF) Computer on an SD Card, give it to me, and 
. 4 I'l have it for free! 
At 
That won't work, I'm afraid. DSiWare copied 
eS: = ; — to SD Cards will only work on the system 
tee ee oe >| it was downloaded to. You can't just copy 


DSiWare to an SD Card. insert it into 
another system and copy it again. 


4Petit Computer has been installed to the DSi. Touch 
he icon to start. 


2-3 Basic Controls 


Basic Controls 


Now it's time to experience the fun of Petit Computer hands on! In general, Edit Mode is used to 
write programs, while switching the screen to Run Mode allows you to put the programs into action. 
This is different from the way programming works on a home computer, but you'll soon get the hang 
of it. Now, let's try running some of the sample programs included with Petit Computer and get back 
to the simple pleasures of BASIC. 


Petit Computer combines Touch Screen keyboard controls with input from the DSi and 3DS 
system buttons. Please see below for a detailed breakdown of the buttons used. The keyboard is 
displayed on the lower screen, and you can switch between alphanumeric and symbol displays. 


Petit Computer Button Control 


[Y Button] 
Backspace 


{X Button] 
{A Button] 
{B Button) 


{ +Control Pad] 
Moves cursor. 
Pressing up and 
down will execute the 
preceding command 
in Run Mode. 


{R Button] — [L Button) 


SHIFT key 
{L Button + Left/ 


Right on cursor) 
{START] Skip page 


Run program [L Button + Left/ 
{SELECT] Right on cursor] 


{Power Button] 
Switches the 
system on and off. 


It cannot be used = Stop program Move to top or 

as part of Petit bottom of page 

Computer programs. {[L Button + Y 
Button) 


Delete a line of a program 
Touch Screen Keyboard 


Alphanumeric Keyboard [¥] Symbol Keyboard Kana Keyboard 
UPEBEEPEEETEEIFT| oe LETTE EE] PC PEPP EPFL 
Tey Tet eye ry sp] a E aE Y 


Normal Display 


AUNUEECRGUHERU  FANGeNBOBCCUGURE 
SHIFT key or MUSGQGEDEGGGNEGR = BNBGNGUEUoUMED 
SHIFT key or EEG gouaOGUeeGU IT PLETE EFFI 
SURGCGDCUGNNGEE? GMRNUSCUOROGUEEe 
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Petit Computer has three screen modes: Run Mode, Edit Mode and the Manual, which displays 
usage instructions. By pressing the appropriate button on the lower Touch Screen, it's easy to switch 
between these modes. When first starting Petit Computer, you will begin in Run Mode. 


@ Function Keys: Allows you to select functions by pressing a single key. 
In Run Mode, these include useful commands such as 
FILES, LOAD", SAVE", CONT and RUN. 

® Close Button ‘Exits Petit Computer and returns to the main Nintendo 
DSi or 3DS menu screen. Press this button and you will 
be asked to confirm whether you wish to exit. Select 
'Yes' to proceed. 

@® Help Button ‘Opens a screen displaying usage instructions. 

@® Run Button ‘Switches to Run Mode and runs the program. While 
programs are running, it functions as a PAUSE button. 

® Edit Button : Switches to Edit Mode. 


Please note that in addition to @ above, you can also press POWER to exit Petit Computer. Be 
aware that a confirmation message will not be displayed in this case, and that if you keep POWER 
held down, the system will shut down. The commands assigned to function keys in © above can be 
changed using a KEY command. Refer to the Petit Computer Resources section at the end of this 
guide for more information. 


@Run Mode 


This mode allows you to run the programs you have created in Edit Mode. In addition, when no 
program is being run, you can enter special Run Mode commands of up to 32 characters (see page 
52). Remember to always include ENTER at the end of your commands. If the command can be run 
correctly, an OK message will be displayed. If it cannot be run, an ERROR message will be displayed. 


Up/Down on :Input preceding command 

+Control Pad 

Left/Right on :Move cursor left and right 

+Control Pad 

Y Button :Delete character to left of cursor 
START :Run program (same as RUN command) 
Left on +Control Pad : Reset screen. A useful command when 
+RButton+ START the screen display becomes difficult to read. 
SELECT :Stop program 


While programs are running, the RUN (ig ee Ba (V)[<)b) 


button will operate as a PAUSE button. Use 


this to pause programs mid-way through. a8) gy - ee a 
-*) S888 


2-3 Basic Controls 


@ Edit Mode 

This mode allows you to write and edit programs. Unlike in Run Mode, you can enter programs 
over multiple lines. The maximum number of lines for a program is 9999, with a limit of around 100 
characters per line. (The maximum number of characters in a program is approximately 520,000.) 
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Note that programs you are currently working on will be lost if you switch the system's power off, 


so be sure to use the SAVE command to store your progress. 


+Control Pad : Move cursor. 
Y Button : Delete character to left of cursor. 
+Control Pad : Move cursor to next screen or 


+L Button preceding screen. Useful for navigating 
longer programs. 
START : Switch to Run Mode and run program. 
System lcons_ : These are the cursor icons displayed at 
the bottom right. 


These icons can be used in Edit Mode to ag) £17 | SAMOG) 
move the cursor. You can also press w to use _ ie ca ie cE 
the copy-paste function. Pressing COPY will 


copy the entire line from the cursor's current (ea) 47 ae | [2] iS] | | 


location. Pressing PASTE will insert this line 
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directly after the cursor. 


@ Manual 
This allows you to access the usage instructions for Petit (?)(RBAmaeRUS) |Y) 


Computer, giving explanations of the software's key functions, 


system variables and commands. 
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“at's Check Out the Sample Programs 


The real joy of Petit Computer is creating your very own programs. But before you come to 
write your own programs, it's good to get a feel for the software with the sample programs that are 
included with Petit Computer. Before giving a brief overview of these programs, let's look at how to 


run them. 


The EXEC command tells the system to read a program from the file and run it. So, for instance, if 
you want to run SAMPLE1, you would input the following command on the keyboard in Run Mode. 


EXEC" SANPLE1" @ 


By modifying the text in inverted commas, you will be able to run other programs (SAMPLE1-7). 
You could also use the LOAD and RUN commands to perform the same operation. 

If you run a number of programs in succession, the on-screen display may become corrupted. 
This is because data from a previous program has not been deleted, and is affecting the program 
that is currently running. If this occurs, you can either restart Petit Computer, or refer to page 49 for 


more information on how to reset data. 


Petit Computer includes 13 different programs written in BASIC. In this section, we will look at the 
7 most elementary programs. The contents of these programs are not overly complex, and beginners 
to BASIC should be able to grasp how the programs function by taking a look at the program list in 
Edit Mode. 


@ FILE 'SAMPLE1' 


This is a program that displays an array of characters. It is a very short program, and 'OK' 
is displayed to indicate that it has finished running. It is a great first step for a would-be 
programmer as it demonstrates the fundamentals of text display and variable usage. 


=-Hd Check Out the Sample Programs 


@ FILE 'SAMPLE2' 


This is a simple calculation program, making use of character input. By inputting a 
numeral in response to the first and second questions, and then inputting the symbol for 
a mathematical function (+ - / % *) in response to the third question, the result will be 
calculated and displayed. For example, if you wish to calculate 2x3, you would touch '2', 
'3', and *' on the keyboard. Take a look at 
the program and you'll see how a result is 
calculated from the inputted numbers. 


L 
SNAREDRUM 


@ FILE 'SAMPLES3' Saat 


This is a simple synthesizer program controlled via the keyboard. You can also press the 
+Control Pad to play cymbals. It serves as a good example of how button input data is 
processed, and how audio samples are played. 


@ FILE 'SAMPLE4' 


This program is a number guessing game. By entering a number between 0 and 99, you will 
try to guess the number the computer has generated. You will be given hints as to whether 
the number you entered is greater or smaller than the correct answer. The program includes 
commands for generating random numbers, as 
well as branch instructions for comparing the 
number you entered to the original number the 
computer generated. 


@ FILE 'SAMPLES' 


This is a program designed purely for fun which gives false biorhythm information. Enter 
your birthday and the program will generate graphs showing information on your body. 
emotions and intelligence. It utilizes the SIN function to calculate and create curves. 


@ FILE 'SAMPLE6' 


This program lets you use a sequencer with up to 8 tracks played simultaneously. By touching 
the lower screen, you can select the sound you wish to be played. Pressing left and right on the 
+Control Pad will adjust the tempo. Pressing the X Button will clear the data you have entered. 


@ FILE 'SAMPLE7' 


This program replicates a classic alien invader game. Press left and right on the +Control 
Pad to move your craft. and touch the lower screen to fire at your alien foes. This program 
provides a useful reference for manipulating multiple sprites, as well as collision detection. 
Please note that this is not a complete game, as there is no collision detection for when the 
enemy missiles hit you. 
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PART2 Getting to Grips with Petit Computer 


In this section, we will introduce 3 of the game programs that come included with Petit Computer. 
Run these games in the same way described in the last section, by entering EXEC "File Name". For 
users with programming experience, please feel free to modify the source code and see what you 
can come up with. Please note that you cannot overwrite the original program with your modified 
version, but you can save it under a different file name. 


eEEEEEEESUECEESESES 7] S998 @ RACING GAME (FILE”GAME1") 


tees : ~942 This game is known as 'Dot Racer'. You control a car and your aim is to collect all 
tees : the dots that line the course while avoiding rival cars. You can use the +Control Pad 
PEON [Or [ : to change the track you are racing around. Be careful, as the more dots you collect, 
the faster you will go. 


Advice of improvement 


Line 222 of the source code relates to the speed of your car. If you reduce 


the amount that is subtracted during the speed calculation, your car will 
accelerate less rapidly. 


@ Role Playing GAME (FILE”GAME2”) 


This is a first-person dungeon crawling game. You will explore a labyrinth while 
taking out enemies. If you complete all 3 levels, the game will end. 


Advice of improvement 


Line 72 of the source code contains the calculation for random encounters 
with enemies. Line 390 determines the damage inflicted on the player. Line 
403 determines the damage inflicted on foes. If you are finding the game 
difficult, you can make it easier by adjusting the values in these lines. 


@ Shooting GAME (FILE”GAME3”) 


This simple shooting game utilizes the sprite function. It even features end-of-level 
bosses. 


Advice of improvement 


Modifying line 361 of the source code as shown below will make enemy bullets 
all fly towards you (with the exception of the bosses' bullets). 


ENSHDIRCESHTCHTS=ATANCNYaA-ENNACT 3 


SiR STS Une ts ul ake 


Dr 
Doct 


pany 
afeute 


“S44 
wv 

ul 
oor 


TTT 
mow 


Cie 


—e 
+A 
ena Li | 


es 


m4 


TU TTT 


on 
aH 
TLD 


Ho 


“AJ 
“um 


Learning to Program 
with Petit Computer 


OO WS 


In this chapter, we will look at some simple programming 
techniques. You will be able to get an idea of the true fun 
of Petit Computer as you learn to create the images and 
sounds you want by simply tapping the keyboard. 


: 3 - 5] 1 The Basics Of BASIC crrcsrresscsssetseeteeeeeeeeeeeteeeeeeeeneeeeeeeeeees OO4B J 
3 3 - | 2 Displaying (@1 a=) ar=\e1 =) > eee GREER 
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is B—Bd Drawing Pictures veccceeceereteeeeeeeteseeeeeeeteneeensenenenenens 058 J 
@NE B—BE Making MUSIC vrceeeereeeeseeteteeeeeeeeeeteteneeeeeeeneneneenenenetens UBD J 
thy 3-86 Exchanging Files with Other Users sss iE» 
bE, 
NEW Special Section Single-Screen Programming Corner. -+++++-+++++++: JO0BU 
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Tell me about the 
« J good old days! 
Well. | remember the 'PC Dojo' * on the fe co a 
'PC Sunday’ programme. 


2-H UT 


Dray. 


Umm... | think you're 
going to have to 
explain what that 
means. 
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*'PC Sunday' was a legendary program in Japan, 
broadcast from 1982-89 on TV Osaka. 'PC Dojo' was a 
specialist programming section. 
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PART 3 Learning to Program with Petit Computer 


cia imae The Basics of BASIC 


Petit Computer uses its own unique version of the BASIC programming language. It uses the latest 
technology to revive the BASIC language that many of us remember so fondly. 

The way that programs are written does not differ fundamentally from the original BASIC, but 
there are a few minor differences. For instance, on Petit Computer, there is no need to enter line 
numbers. You can simply add labels to indicate which lines GOTO and GOSUB commands should go 
to. There are also a number of functions and commands specifically for use on the Nintendo DSi and 
3DS. Users who are familiar with BASIC should pay special attention to these new elements. 


If you are reading this guide, there is a good chance that you are already familiar with BASIC to 
some degree. Perhaps you think that you have no need for a refresher course. But it never hurts to 
go back to first principles, to remind yourself of the commands without which you cannot program. 
Whether it's your first time programming, or you have not programmed in years, it is well worth 
reading this section. 

Petit Computer contains sample programs for reference, which were introduced in Part 2-03 of 
this guide. It is a great idea to take a look at these programs' source code as the first step towards 
writing your own programs. 


@ Assign & Output 


A value or character string can be assigned to a variable with an equals sign (=), and this can be outputted 
by using the PRINT command. Even if you are already familiar with this, it is always worth going over the 
absolute basics again. 

The most simple sample program included with this software is the one which displays two values and then 
calculates and displays the final total. This is SAMPLE1. 


From sample program 'SAMPLE1' 


APPLE=56 
GE ORANGE=123 


GEE LOCATE 5,14 
GES PRINT" Usd = 
GE LOCATE 5,11 
GERPRINT"Sn> = 


LOCATE 5,13 
TE TOTAL=APPLE+ORANGE 
TEP PRINT" 3° 994= "3 TOTAL 


";APPLE;"3" 


> 5 OSS ILET SS 6 ty ale 


+The number 56 has been entered for the variable 'APPLE'. 
«The number 123 has been entered for the variable ‘ORANGE’. 


«Display coordinates (for on-screen location). 
«Displays value entered for 'APPLE' 


Displays value entered for 'ORANGE' 


«The two variable values are added together and 
assigned to the variable 'TOTAL'. 
Displays value for variable 'TOTAL'. 


3-1 The Basics of BASIC 


Lines 21 and 22 of the source code relate to the variables that give the number of APPLES and ORANGES. 
Lines 25-28 relate to the different values needed for the calculation, while lines 31-33 display the total. 

Line 26 uses a PRINT command to display the number of apples. You will note that some terms appear in 
the program in "speech marks", while the word APPLE does not. The speech marks tell the program to treat 
the text contained within them as character strings - this means they are displayed on-screen precisely as they 
appear in the program. In contrast, the word APPLE, which is not contained within speech marks, is treated as 
a numerical value, and the value assigned to it in line 21 should be displayed (56). 

In line 32, both values are added together in order to calculate the total. This total is a new variable that 
is assigned by using TOTAL. The LOCATE command indicates the coordinates where the characters should 
be displayed on-screen. To learn more about how to display characters on-screen, please refer to Part 3-02 
‘Displaying Characters’, on page 53. 

In earlier versions of the BASIC programming languages, the equals sign '=' was often used both for 
assigning values, as well as for indicating whether or not a value is equal (as what is known as a relational 
operator). In Petit Computer, a single equals sign '=' is used to indicate that a value has been assigned to 
something, while a double equals sign '==' is used to indicate whether two values are equal or not. For more 
details, please refer to the section on relational operators on page 51. To clarify, if you write 'A=1' in a program 
it means that the value '1' has been assigned to the variable A. However, if you wish to compare the values 'A' 
and '1' to see whether or not they are equal, you should write it with a double equals sign: 'A==1'. 

@ Conditions & Branches 


In order to calculate whether or not specific conditions have been met, you will use an IF~THEN operation. 
If you wish to make the program go to a certain line or section, you will use a GOTO command. A subroutine is 
a self-contained section within the source code which you can get the program to repeatedly return to. To go 
to a specific subroutine, you will use the GOSUB command, while the RETURN command will designate the line 
of the program to go back to. Petit Computer programs do not use line numbers. Instead, labels are assigned to 
the lines where you wish GOTO and GOSUB commands to go to. Use @ along with the label name to indicate a 
line. 

To see a simple program where IF ~ THEN and GOTO commands are used, please refer to the sample 
program, SAMPLE2. In this program, 2 numerical values are entered, along with the symbol for a basic 
arithmetical operation (+ - / %*) and the final result is displayed. 


From sample program 'SAMPLE2' 


HEF @ LOOP 

TE IHPUT"G: ives 29ee 8" | HOLL +Value of inputted button is assigned to variable 'NO1'. 
IHPUT"@: 2937 292" 4" ,HO2 ~Value of inputted button is assigned to variable 'NO2’. 
TE INPUT" @: Fa" ON ¢+t-47489 "SKF «Character of inputted button is assigned to character 
: variable K$. 

HER HARK =8 +O is assigned to variable 'MARK'. 

GEER IF K#=="+" THEH HARERERL <lf the inputted key is + then the value of the variable 
. 'MARK' changes to 1. 


* To Next Page * 


wat 
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PART 3 Learning to Program with Petit Computer 


TON HARE GOTO @SKIP, @PLUS, <'If the variable 'MARK' is O then go to @SKIP, and if it is 1 
. then go to @PLUS. 


TE @ SKIP 

TE @ PLUS 

TEP PRINT NOL;"+";N02;"=";NOL+NhO02 «Display the sum of variables NO1 and NO2. 
HEF GOTO #¢LooP «Return to @LOOP line. 


The INPUT command means that you wish a value inputted via the keyboard to be assigned 
to a variable. The IF in line 35 indicates a conditional operation, meaning that if the '+' symbol was 
entered on the keyboard, the variable MARK will be assigned a '1'. The subsequent lines contain 
other conditional operations, for instance, if '-' was entered, it will be assigned a '2’, if '/' was entered, 
it will be assigned a value of '3' and so on. 

The ON~GOTO command in line 40 introduces several options into the GOTO operation. So if the 
variable MARK has the value of 'O’", it will go to a certain line, while if it has a value of '1' or '2' it will 
go to others. This means that the program will run differently depending on the key that was pressed. 

The GOTO command in line 50 indicates that the program will return to the line marked with the @ 
LOOP label, meaning that the program will be ready to perform another calculation. 

In the version of the BASIC language used in Petit Computer, there is no ELSE command, meaning 
that you cannot have two different processes occurring in the same line of the program. For more 
details, please refer to the section on branching instructions on page 59. 


@ Repeated Operations & Array Variables 
FOR ~ NEXT are the typical commands used to repeat the same operation. An array variable 

is where a number is assigned to multiple variables, allowing them to be managed in a uniform way. 
They are often used in programming, and examples are given for reference in pages 106 and 113 of 
Part 5 of this guide. 

In the sample program SAMPLES, a FOR~ NEXT command is used to assign data to the array 
variable DIM ( ). A range of sounds will be played depending on the key pressed, meaning that the 
program operates like a basic sequencer. 


From sample program 'SAMPLE3' 


HEPOCATA "?7","A" «Multiple data prepared. 


Te DATA "x" 


TEER DIM H#c¢ 283 +20 array variables from N$(O)~N$(19) prepared. 

Tt ECHT=28 +Set number of loops with variable KCNT. 

Toe FOR I=8 TO KCHT-i «Program loops until the value of variable [1] is 
between O and 19. 

GEER READ NFeTa «DATA command used to load one of N$ variables. 

TEER HEAT I «Returns to line 41. 


3-1 The Basics of BASIC 


The READ command in line 42 serves to take the 20 pieces of data between lines 24-35 and 
store them as variables. In order to store them all as variables, this same READ command needs to 
be repeated 20 times. This is why the variable 20 appears in line 39, meaning that lines 40-43 are 
looped and the same command is repeated 20 times. 


There are a number of other ways to repeat sequences in programs. Please note how line 50 of 
SAMPLE2 contains a GOTO LOOP@ command, meaning that it returns to the @LOOP label in line 13, 
so the program will run again and again. Please note that FOR~ NEXT operations, where the number 
of times the process should be repeated can be designated, are different from the looping that takes 
place using a GOTO command. 


How to Write a Program that Repeats 100 Times 


FOR I=i TO i184 
IOI II Ioooo «Enter process you wish to be repeated here. 
HET 


How to Write a Program that Repeats Forever. 


@MHAIN 
IOI IIIS «Enter process you wish to be repeated here. 
GOTO #NAIH 
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Resetting Memory and Screen 


The controls and commands below perform a variety of functions, such as resetting the memory or screen, or pausing operations. 
These commands can be used within programs, and also in Run Mode. There are times when a program does not run correctly 
because data from a previous program is interfering. If this should occur, try using the commands or pressing the buttons listed 
below. (Please refer to Part 4 for more details on screen elements, background display and sprites). 


+Control Pad + R Button + START Reset screen 

CLEAR Clear memory and variable names 
VISIBLE 1,1,1,1,1,1@ Display all screen elements 

GPAGE & Return controlled graphic screen to the upper screen 
GCLS & Delete graphic screen 

BGFAGE & Return BG screen to upper screen 
BGCLIP 6, &@, 31, 23 Reset BG display range 

BGOFS 8, 4,48 Reset BG front screen offset 

BGOFS 1,46, 48 Reset BG rear screen offset 

SPPAGE & Return controlled sprite screen to upper screen 
SPCLE Delete sprite 

BENSTOFP «Stop background music 


PART 3 Learning to Program with Petit Computer 


One of the fundamentals of programming is the repeated process of input, calculation and output. 


This makes it vital to have a solid grasp of how to assign inputted values to variables, and how 


arithmetical operators are used to calculate values. Before starting to write your own programs, it's 


best to review these programming basics. 


@ Numerical Values 


Display 


This software uses 32 bit fixed-point numbers, with fractions rounded [hexadecimal|  &H 


up. Integers within the range of +524287 can be used (internally, 


4096 is binary &B 


treated as 1.0). Numbers can be written in either hexadecimal or binary form. 


How to program 


PRIHT &BL21111111(CGa) <A binary value will be displayed as a decima 


PRIHT &H&F +A hexadecimal value will be displayed as a decimal value. In this case, '15' will be displayed. 


| value. In this case, '255' will be displayed. 


@ Calculation and Arithmetical Operators Priority Calculations 


(2H 


Arithmetical operators are the signs and 


symbols used when performing calculations. 


MINUS NOT 


In Petit Computer, the remainder in a division 


Function 


x 7 


calculation is represented as '%', which is the 


same as in the C programming language. 


I= _< < > > 


How to program 


AND OR XOR 


Pelee WAY ab(sleecs +This division calculation will not give a who! 


le number. 3.383 will be displayed. 


PRINT 2+3*3 +lIn this calculation, the multiplication will take p 


ace first, meaning that the result will be '11'. 


@ Bit Operators 


Bit operators are also known as logical 


operators and are the signs and symbols used to Logical product (if A and B are '1' then '1') 


Bit Operators 


perform logical operations. Using them is a way of Logical sum (if A or B are '1' then '1)) 


determining whether something is true or false in Exclusive OR operation (if only A or B is ‘{' then '1' 


a binary calculation, and is extremely useful when Negative ( 
manipulating bits. 


How to program 


if'1' then ‘0! if 'O' then '1') 


A=A OR &H1i#e +The logical sum of &H100 and the variable 


A=A AND 15Cy +The logical product 15 and the variable A will be assigned to A. 


A will be assigned to A. 


3-1 The Basics of BASIC 


@ Relational operators 
Relational operators are the signs and symbols used 


Relational 
Type Operator 


Value on left is greater than value on right 


for calculations where values are being compared. In Petit 


Value on left is smaller than value on right 


wt 


Computer, the signs '=' and '< >' are not used to express 


: . Value on left is greater than or equal 
whether values are equal or not. As with the C programming _ | to value on right 


is j j — y=! Value on left is smaller than or equal 
language, this is expressed using and '!="'. evalua onriert 


Note that when brackets are placed around values, it | Both values are equal 


becomes a logical operation. If the calculation gives a true |The values are not equal 


result, this will be expressed as '1' (for YES). On some 
other version of BASIC, this is expressed as '-1' so please take note of this difference. 


How to program 


Flee WRIT th al 3836) 21 [PA Results of comparison is true so '1' is displayed. 


@ Variables 

Variables can be given names of a maximum of 8 characters. Alphanumeric characters can be 
used along with underscore '_'. The names should begin with a letter. If you end a variable name with 
a'$', it will be treated as a character string. 
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A' and 'A$' can be used as separate variables. 


How to program 


A=4.333 Assign numerical value 0.333 to variable A 
A#="HNOTI" Assign character value "MOuI" to variable A$ 


@ Array Variables 

To perform array declarations, the command DIM is used. An array can have a total of up to 
32768 elements, in up to two dimensions. The Parentheses () or [] can be used, and indexing begins 
from 0. If you define the same array twice, a duplicate definition error will occur. To prevent this, 
ensure that you use a CLEAR command before any new operation. 

For examples of programs that use arrays, please refer to the sample program @ in the 100 Line 
Programming Corner section on page 95. 


How to program 


CLEAR +Clears variable. 
DIN ACLeS Create A(0)~A(Q) array variable. 
ACHs=123d 50) ~Assign 12345 to A(O) 


PART 3 Learning to Program with Petit Computer 


To check that a programming is running as expected, it's a good idea to regularly switch from Edit 
Mode to Run Mode to test it out. 

This section looks at the commands that are chiefly used in Run Mode. They are all commands 
that those familiar with BASIC will already know. 


RUM Gy 


To run a program you have created in Edit Mode, enter RUN in Run Mode and press the Enter 
key. (You can perform the same operation by pressing the START button). 


CONTE 


Use this command to restart a program that you paused by pressing SELECT or using a STOP 
command in the program. 


SAVE"FILE" @ 


This command is used to save files. If you switch the power off, you will lose the program entered 
in Edit Mode. To avoid this, use this command in Run Mode to save your files. 


LOAD" FILE" @ 


This command is used to load files. 


EXEC"FILE" @ 


This command loads files and runs them. It combines both the LOAD and RUN commands in one. 


FILESG) 


This displays a list of your files. Use this command when you wish to see the files you have 
saved. 


LIST [line number] 


This command switches to Edit Mode and displays the program list. If you omit the line number, 
the program will be displayed, starting from the first line. 


HEH Gy 


This command will delete the entire program you are currently writing in Edit Mode. 


* File names can be a maximum of 8 characters long. using alphanumeric characters and the underscore ''. 
* FILES"LOAD"SAVE"CONT"RUN' each have function keys you can make use of. 


3-2 Displaying Characters 


Displaying Characters 


It is now time to actually get programming. Let's begin with an introduction to how to display 
characters on screen. It's important to grasp how coordinates for the display are used, as well as the 
particular way the make-up of the display in Petit Computer. 


The console screen is where characters are displayed. The console screen appears on the upper 
screen. Please see page 80 for more information on screen structure. The console screen allows 
alphanumeric text display of 32 characters x 24 lines. 

If you add a new line at the bottom of the screen, the screen will scroll down by a single line. 


0 — X Coordinate = 31 


32 character 

0 

| Each character is 
pe a 8x8 pixels in size. 
8 24 * 
a lines - 
= 
I 
(a>) 


| 


23-- 


Console screen. 


& 32x24 characters can be displayed on the console screen. 


P 
E 
R 
4 
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PART 3 Learning to Program with Petit Computer 


= Designating Coordinates and 

Displaying Characters “PRINT,LOCATE” 

The PRINT command is a classic BASIC command, and is used to display characters on the console screen. 
When you want to designate the coordinates where characters should be displayed, you will use a LOCATE 
command. In this section, we will look at an example program that utilizes the LOCATE command. The desired 
coordinates are expressed in a formula, and a line break is added every 16 characters. 


All characters are displayed on the console screen.(EXAMPLE 3-01) 


[es |L es 

TF FOR C=8 TO 255 +The process for 0~255 is repeated. 
PEER LOCATE C€#16, FLOOR ¢€C+163 <Thedisplay coordinates are set here. 
THe PRIWHT CHR «C4 +The characters to display 
TE NEXT appear here. 


When the program is run, a total of 256 (16x16) characters are displayed on 
the console screen. The variable C used in the program stands for the character 
code, and using the function CHR$ prints the characters. 

A floor function is one which looks for an integer, so for instance if the 
argument is '1.234' as in the example program 3-01 displayed above, the value 
'1' will be returned. 


4 Screen when Program is 
Run(EXAMPLES-01) 


An INPUT command gives alphanumeric characters entered on the keyboard a value and assigns them to a 
variable. Note that after entering the text, you need to press ENTER. 
This is an example program using an INPUT command which analyzes numbers entered via the keyboard. 


EXAMPLE 3-02: Distinguishing Between Prime and Non-Prime Numbers 


oe CLS 

PEER THPUT "292" 34L7" 548 +The value entered will be assigned to A. 
DEF B= 8 

TTF FOR D=2 TO A-1L + Displayed if value is divisible. 
PEP IF fAXDS ==8 THEM BHi:7 "¥";o 

DoE HE &T 

Tie IF B==8 THEM #"¥290 7° 2" +f the value is a prime number. 

EEF IF B THEN ?"¥ RO 2" pt" +f the value is not a prime number. 


When the program is run, and a particular value is entered via the keyboard, 
it will be determined whether or not this value is a prime number. The '?' symbol 


used in the program stands in for the PRINT command. Try using it in yourown Screen when Program is 
Run(EXAMPLE 3-02) 
programs. 


3-3 Control Input Detection 


circ Control Inout Detection 


wat 


Petit Computer is able to detect which buttons the user presses or which Touch Screen 


operations the user performs. By making use of this capability, it offers a fun way to program which 
is only possible on the Nintendo DSi or 3DS systems. 


To detect the button response, you use a BUTTON 


() function. When a particular button is pressed, the aaalue Wate neuinenienann ern 
function returns a value that turns each bit from '0' to '1'. 
OOOOOO000O00 1 UP 

To see the returned value for each button, please refer 00000000010 | DOWN 
to the table to the right. Try using the bit operator AND OOOO000001 00 LEFT 
and write a program which displays whether or not a 00000001000 RIGHT 
button has been pressed 00000010000 

e 00000100000 


Q0001 000000 
00010000000 
00100000000 
01 000000000 
10000000000 | START 
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Display the buttons that have been pressed(EXAMPLE3-03) 


@MHAINH 

EEF B=BUTTOH« 3 «Assign detection of a button state. 
PEER M= 28d 3 «Reset value used for mask. 

PEF PRINT "&E" ; 

TF FOR I=1i TO 12 Repeat 12 bit section. 

PRIHT ¢tB AND MNal=85; Add linebreak after displaying 12 bit section. 
NH=H-2 

HEXT 

PRINT 

GOTO #haArIn +Display value for a single bit. 


When the program is run, it will display whether or not buttons 
have been pressed in binary code over 12 digits. By pressing different 
buttons, you will be able to see how the values change. 

The value returned from SELECT is 2048, but since this button has 


A The A Button has been pressed in 


been assigned to pausing programs, SELECT cannot be detected in __ this example.Screen when Program 
is Run(EXAMPLE 3-03) 


programs. 


PART 3 Learning to Program with Petit Computer 


If you don't press ENTER after inputting a value, the INPUT command will not be finalized. But 
using the INKEY$ function will allow detection of the key being pressed at a particular moment. By 
making use of this function in a program where instantaneous action is called for, you can create 
something really fun. 

The program shown below will enlarge the characters read by the INKEY$ function. 


INKEY$ Function (Input by keyboard) (EXAMPLE3-03) 


The CLS 

TE @ MATH 

TEER AF= INK EV $C 3 «Single character entry on 
the keyboard. 

To IF AF=="" THEM #@hHATH 

TE CHR READS" BGFa", ASCCAFS3, BFS + Character data input. 

Ti FOR I=8 TO 63 

To VEVALC"BRH" +HIDFtcBFt, 1,133 «Converts a character string 
into a numerical value. 

To IF W==8 THEW PRIHT " "; 

TER IF VW!l=8 THEH PRIHT "i" ; 

Te IF ¢1485==7 THEN PRINT 

Te HET 

TH GOTO @haAIn 


After running the program, any key you touch on the keyboard will be displayed 8 times larger 
than normal. The function CHRREAD() retrieves character data, while the MID$() function retrieves 
the designated number of characters from a character string, and VAL() converts them into a 
numerical value. For more information on functions, please refer to the Petit Computer Resources 
section at the end of this guide. 

You can use this method of enlarging characters in other programs. 


A The characters you enter will be displayed across 
he whole screen area.Screen when Program is 
Run(EXAMPLE 38-04) 


3-3 Control Input Detection 


Petit Computer makes use of system variables that detect data inputted from the Touch Screen. 


See the sample program below for an example of this. It deletes the keyboard display on the lower 


screen and draws on the graphic screen beneath it. 


Ink painting by inputted from the Touch Screen. (EXAMPLES-05) 


Ge PHLTYPE "OFF" 

GTR GPAGE 1 

GEER GFILL &, 8, 255,191, 247 
Co @hAltH 

MF IF TCHST==8 THEN @NAIN 
ns 4=TCHsa: Y=TCHY 

FOR Yi=-d TO 4 

Me FOR #xi=-d TO a4 

MEP Tete: Javtv1 

GH C=GSPOITCI, Jat+l 

GB IF C2255 THEN C=255 
GH GPSET I,J,C 

CORED HE eT 

COE HE es T 

ese VSYHC 1 

CE GOTO @haAlb 


«This removes the keyboard. 


«The screen is filled with the color 
code 247. 


«The program waits until the screen is touched. 


«Coordinates are assigned where the 
screen was touched. 
«Repeats for 9x9 pixel section. 


«Adds 1 to the color code displayed on screen 


«If color code exceeds 255, the 
program goes back. 
«Draws on screen. 


+Waits. 


If you touch the lower screen after running the program, that section will be colored in. The color 


will get deeper depending on how long you touch the screen for, meaning that you can create an 


image that resembles an ink painting. The system variables TCHST, TCHX and TCHY are used to 


detect the state of the Touch Screen. For more information on system variables, please refer to the 


Petit Computer Resources section at the end of this 


guide. 


This program also uses the VSYNC command 
to adjust the speed at which images are drawn. A 
single frame is around 1/60th of a second. Please 
also note that once this program is run, graphics will 
be displayed on the lower screen. Use a GPAGE O 


command to restore this to the upper screen. 


4 Screen when Program is Run(EXAMPLE 3-05) 
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cia Drawing Pictures 


In the original versions of BASIC, graphic commands tended to differ widely between different 
systems. The version of BASIC used in Petit Computer is quite different from older version of the 
programming language. 

The screen display in Petit Computer is made up of multiple layers. You can program graphics 
using sprite-based characters and backgrounds. This will be covered in detail in Part 4 of this guide. 
Prior to that, this section will introduce some of the basics of graphics programming. 


& The Graphic Screen = “x oat — 255 


There is a graphic screen on both the upper and lower 
screens, each allowing graphics to be drawn over a range 
of 256x192 pixels. (Refer to the diagram on the right). 

In the version of BASIC used in Petit Computer, 
functions and commands relating to graphics begin with 


a}EUIPJOOD A 


= 


o_— 


= 


G~. So for instance, GLINE is the command to draw a 


graphic screen 


Let's begin by drawing lines, dots and circles on the = 4 The graphic screen has a resolution of 256x192 pixels 


line, while GCIRCLE will draw a circle. 


screen. 


Draw lines, dots, circles and enlarged characters.(EXAMPLE3-06) 


[es|L ee} Tey LCs Leer +clear the graphic screen. 

MEF GLINE 8, 6d,6d,128,15 + Draw a line. 

DEER GPSET 396, 96,15 + Draw a point. 

GH GCIRCLE 168, 96,16,15 +Draw a circle. 

EF GPUTCHR 192, 64, "BGF&",6, &, & Display characters on the graphic screen. 


When the program is run, lines, dots, circles and enlarged 
characters will be drawn on the graphic screen. Unlike on the 
console screen, the graphic screen gives you the ability to 
control the graphical display to the level of individual pixels. 

Running GCLS will clear the graphic screen. 


Screen when Program is Run(EXAMPLE 3-06) 


3-4 Drawing Pictures 


P 
E 
R 
J 


The graphic screen can display 256 colors. The following program takes red, green and blue and 


combines 6 shades of each of these colors, totaling 6x6x6=216 colors. 


:® 
EXAMPLE 3-07: Display Mix of Red-Green-Blue 5 
Te GCLS ig 
TEE R= 3:G=3:B=3 + Settings for red, green and blue. : 0 
OE @MAIN ig 
i CLS is 
TM PRINT "R=";R;" G=";6;" B=";B SS ea fomred: z 
C=CR#¥369+¢CG#69+B «Calculates the color number. i= 
We is (nllelh) (ne sel yo «Revises the color number. ss 
eile WEIL, Veh tela vata. ab‘s}al = 16, +Draws a filled square graphic. : % 
VSYHC 6 «Waits for a certain period. iS 
To @K WAIT :§ 
Dee K=BUTTONS 3 +Input via the buttons. i? 
IF K== THEH #@KHAIT +Waits for button input. : o} 
IF K==16 THEN R=CR+13946 «Cycle through shades of red. : 
IF K==32 THEN G=¢64+1946 Cycle through shades of green. 
IF K==6d THEN BC B+1946 +Cycle through shades of blue. 
Ht GOTO @hAIn 


When the program is run, it will display a combination of these colors, depending on the values 
entered for red, green and blue (R, G, B). The A Button is assigned to red, the B Button is assigned to 
green, while the X Button is assigned to blue. By pressing each of these buttons, the value (0-5) for 
these colors will change. So, for example, by increasing the values assigned to green and blue, you 
can create a particular watery shade of blue. 


Branching 


To use a command where you want the action taken to 
differ depending on conditions, use either an IF ~ THEN or 
IF~GOTO command. This type of command is essential in 
BASIC programming. With other versions of BASIC, an ELSE lp & 2 THEN @YES 


command is used after the branch instruction telling the | GOOOMGOOOOMaG Enter the process to take place 
in the event of a NO. 


How to program 


program what to do if a certain condition is not met, or an GOTO @G60RYU 


ENDIF command is used to end the conditional processing @yYES 
section of the program. In the version of BASIC used in Petit 
Computer, ELSE and ENDIF commands cannot be used. To 
carry out a branching operation, you use a combination | #GORYU 

of the IF~ THEN and GOTO commands. Please see the | OOOOGOG000000 NS alee 
example program in this section to see these commands in 

action. 


IO000090000000 <Enter the process to take place 
in the event of a YES. 


PART 3 Learning to Program with Petit Computer 


ciate Playing Sounds 


As we come to the end of Part 3, we will look at how to perform audio programming using Petit 
Computer. The software comes with a rich variety of audio content in its sound library. In this section, 
we will look at some programs that make use of these sounds. 


There are 30 background music tracks that come pre-loaded on Petit Computer. By using the 
BGMPLAY command, you can play a piece of music on a loop while a program is running. 


Playing Background Music on a Loop(EXAMPLE3-08) 


i CLS 
EF @ MATH 
TEER PRINT "PUSH ANY BUTTON" 
ETF @ WATT 
re IF BUTTONS s==8 THEN @HAIT <The program waits for button input. 
TF H=RHOe Seo +A random number between 0-29 is 
TP PRINT "“NUMBER=";4N een 
BGMPLAY 4H +A background music track is played { 
YSYNC 36 +Pause for 0.5 seconds. i 
Te GOTO @haArH E _BUTTON 
F UTTON 
i: UTTON 
When the program is run, pressing any button (with the exception fe =U 
of SELECT) will play a random music track from the 30 included with e nae 
the software. If you cannot hear anything, please check the system 5 UTTON 


volume. a The screen display when example 
program 3-08 is run. Press any button 
and a music track will be played at 
will continue playing. To stop the music, you will need to enter a — ;andom. and the BGM track number 


BGMSTOP (4) command in Run Mode. will be displayed. 


Please note that even if you stop this program, the music 


You can play up to 70 types of sound effect using Petit Computer. To play a sound effect, you use 
the BEEP command. In example program 3-09, a BEEP effect is played whenever a button is pressed. 


3-85 Playing Sounds 


Playing the BEEP.(EXAMPLE3-09) BUTTON 
-BUTTON 
i CLS ¥° BUTTON 
GE @HAIN e BUTTON 
TEP PFRIWHT "PUSH AHY BUTTON" 3UTTON 
Ti @W AIT BUTTON 
[TE IF BUTTONC}==4 THEN @HAIT “ {he orosiam waits | pegs 
N=RNDE TES eee eos a The screen display when example 
PRINT "NUMNBER=";N generated. program 3-09 is run. Press any button 
ENSlel [hl +A sound effect is played. and a sound effect will be played at 
VSYNHC 36 «Pause for 0.5 seconds. random, and the sound effect number 
GOTO @MAIn will be displayed. 


When the program is run, pressing any button (with the exception of SELECT) will randomly select 
a sound effect from the selection of 70 and play it. You never know what sound effect will be played, 
giving this program an enjoyable unpredictability. 


The BEEP command can do more than simply play regular sound effects. By adjusting the pitch 
of the sound effects, you can play them in different octaves. The example program below shows how 
this function can be used. 

When the program is run, a piano effect will play 'Do Re Mi Fa So La Ti Do' in a continuous loop. 
The pitch will shift relative to the last tone, so it is not an absolutely accurate reproduction of piano 
scales. The values in the DATA line in the program represent musical intervals or steps. The variable V 
represents the volume, the variable W represents the tone, while the variable P controls the panning of 
the audio between the right and left speakers. Try using the techniques used here in your own programs. 


Playing Do Re Mi repeatedly(EXAMPLES- 10) MML can be played too. 
H=22 "*HWAVEC¢8-693 In this section, we will look at MML, which is also 
IER V=Se 7 YOLUMEC@-1273 introduced on the official Petit Computer website. MML is 

- ; a well-known form of syntax used to convert music into 
Gee P= 6d PANPOTC@ “6d 7127) the form of data. This program decodes this syntax and 
ik @S TART replicates this kind of music using only BEEP commands. 
TTA FESTORE @SCORE This will give you a taste of how it feels to make music 


To @hailn using a MIDI device. 
TF READ I 

Go IF I?=99 THEN #5 TART 
TER T=IT¥d 96-12 = 
TF BEEP H, 1, ¥, FP be : <@MML data is 


¥SYNC 15 ine being played. The 
GOTO @NAIN 8 instruments are 


@SCORE layered to create the 
audio track. 
DATA @, 2,4,5, 7, 3,11,127, 99 
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Exchanging Files With Other DSi and 3DS Users 


On Petit Computer, there is no function which enables you to upload files saved on your Nintendo 
DSi or 3DS system to a computer. This means that you cannot save programs to an external device, 
or distribute your program data to a large number of people. However, you can exchange program 
files with other DSi and 3DS users one-to-one via Local Wireless Communications. The more fellow 
Petit Computer users you have around you, the more fun you'll have. 


If you have two Nintendo DSi or 3DS systems with Petit Computer, you can send and receive files 
via local wireless communication. The guide below shows you how. 


"The User Sending Files _ The User Receiving Files 


Run the send command in Run Mode: Run the receive command in Run Mode: 
SEWOGF ILE "Resource Name: File Name" (4) FEC'F I LE "Resource Name: File Name" 


%* You can omit the resource name 
Pt) EE when sending or receiving files. 


: a 
i 
me ALIEN Touch 'Confirm' 


{MHOAND Po ILERIE LES. 
WSAHIDTELS LUITIN? 


Touch 'Confirm' 


SIP ILARELET. 
HIITELSULITIN? 


Touch the name of the 
user you wish to send the 
file to and press ‘Confirm’. 


DPT ILPGRSBFARRLTR SL 


« ° 


( rf |LAS ail 
fem PRG 

oe 6 me Sl |EN 
Receiving file... | gay +5 


DPT IVER TT. 
REHRNSE CHAS FAL. 


DPT IVAREPCTT. 
HENRI OE CHAS RSL 


3-6 Exchanging Files With Other DSi and SDS Users 


When you receive a file, you don't have to use the same file name that the sender used. You are 
free to modify it to a name of your choice. 


wat 
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Image: Hiroshi Kuri 


You will have noticed from the guide that the resource type is displayed on the sender's screen. 
See Part 4-01 for more information on this. In addition to program files, Petit Computer characters, 
screen data and memory data files can also be transferred between users. 
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Special Section oo” 


a 4" 


VaAvV AV AV AV AV AV AV AV AV AV AV AV AV AV AV AV 4 VAY 
Byte-sized Programs to Enjoy 


@ — Single-Screen Programming Corner 


AVAVAV AV AV AV AV AV AV AV AV AV AV AV AV AV AV AV & 


For readers of this guide who are familiar . 


eae ey | 
fl fl - Oa), In this section, we'll take a look at mini- 
with BASIC to some degree but have not used it 5 4 GiOR Teeth auinOncne eeicen: 


for a long time, we hope that the contents thus 
far have inspired memories of programming, and 


The users who came up with these 
that you have got to grips with the fundamentals programs ranged from veteran Ep 
i E A ; programmers to complete beginners. 
of Petit Computer. At this point, we would like 


the author and associates came up with. All of tips from the programmers’ commentary 


to introduce you to a few small programs which AN SIGUGHOI CORUESUT OE CUMTEOTE 
@ y : 
and explanations. 


these programs fit on a single screen of Petit 


Computer, which is 29 characters x 24 lines in Fou IRV GCEM Eee Ionian are 


screen, you can always make some of 


Edit Mode. Test your programming skills and see Firs IO OUATTS MINT Uns @ONSaRL 


what you can achieve with a program in such a 
small space. 


Okinawan Traditional Folk Music Program 


@ Introducing the Program 

Give the Touch Screen a few taps with the stylus, or draw a 
nice big circle for a fantasia of traditional Okinawan folk. 
@ More About the Programmer 

| was born in 1966 and learned BASIC as a high school 
student on the Commodore VIC-1001 and the single-board TK- 
80BS. | also dabbled in assembly language. Subsequently, | made 
sound effects for TV, films and games and now make websites. | 


am not a programmer by profession, but it will always be part of 


A Touch the lower screen and the Sound is 
played. It is heard like melody by moving. 


my life. 


Special Section Single-Screen Programming Corner 


@ How it Works 


Slide the stylus across the Touch Screen in any way you choose. The center of the screen forms the starting 
point, with left and right shifting the sound over 2 octaves. The y-axis is not visible. The characters “ 0.4.26" 
in the second line represent the musical scale typical of traditional Okinawan folk music (after being converted to 
ASCIl, they are assigned to different notes in the scale). The fact that you cannot program a conditional statement 
in the FOR~NEXT line, with more than one command in a single line is a bug and created a bit of a challenge here... 
But this has been fixed in the updated version 1.1 of the software. Though it is rather lacking in visual style, with 
only the cursor appearing, it more than makes up for it with its interesting approach to sonics. 


Program List 


Te PHLTYPE "OFF" : CLEAR: CLS 

GTR DIN Of 219, L¢565:J¢="04260" +The variable U$ is used to create the musical scale. 
TEP SPPAGE 1:SPSET &©,112, 6,6,6,4 

Ti FOR I[=6 TO 3 

Te FOR Il=8 TO 4d 

TH B=ASCCNIDS¢I#, TI, 193 

Te DOT I++ 01 # 595 =B+ Cl eles 

TE HEAT I! 

TEE HEwT I 

TT FOR E=8 TO 49:L¢Es=-1:NERT E 


The variable JS is used to create the musical scale. 


AS 
: © 
: 
. 
aol 
: 
: 09 
rad 
xe) 
: JU 
73 
: oO 
: 0 
: 5 
: # 
:3 
i= 
[et 
> 
: U 
:@ 
: 
:- 
: oO 
fe) 
: 3 
: st 
: <& 
Aa 7 
: @ 
is. ow 


ie @START 

DEP B= TCHA: Y=TCHY: SPOOFS &, 8-8, Y-—8 Displays characters at location on screen that is touched. 

TRER SC=PLOQR CHR 412.8341: 0=0b¢5C3 7 The coordinate on the x-axis where the screen is 
- touched is assigned to the variable S, and a sound is 

TMP S=C-8L192+0C8192 72d 98055 _| played. 


EF Lo ao =-1 
TT IF TCHST==TRUE THEN GoOoSUB @SFP ~<Asoundis played when the screen is touched. 
TF FOR E=1 TO 44 T 
TAP IF LtE? !=-1 THEN GOSUB @5P2 + This is the echo effect process. 
TEER LY SB-Es=Led9-Ea: HEAT E ml 
HEP YSYHC 3:G60TO 85TART 

TE @ SP 

TEP BEEP 16, 5:L¢63=5:RETURH +The subroutine that plays sound. 
TEER @ SP 2 

MER BEEP 16, L¢E3, ¢49-E3#2?:RETURN +The subroutine that replays sound for an echo effect. 


may be no images, but it sounds great! on where the screen is touched. 


The tone is that of a traditional To stop the music getting monotonous, this program 
Japanese string instrument. There uses echo effects and changes in pitch depending 


The echo effect can play an array of up to 50 sound effects, so it is 
possible that the sound effects will be slightly delayed. If this occurs, 
try reducing the number of sound effects in the array, and try adding 
a VSYNC command between rows 17-19. 
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Feel an Exciting Rhythm With Your Fingertips 


@ Introducing the Program 
This program lets you enjoy a simple rhythm game. The aim is to press the buttons in perfect 
sync with the rhythm. You're sure to find it quite a challenge. 


@More About the Programmer 
Well, I'm also responsible for Entry No.1. | hadn't programmed with BASIC for a long time, so | 
got so excited that | came up with two programs in a row. 


@ How it Works 

When the musical notes reach the first line, at the top of the screen, you'll need to press either 
the A or B Button. Press the B Button when the note is on the left, and press the A Button when it is 
on the right. Match the rhythm and aim for a high score. When you are perfectly in sync, you'll hear a 
dog or cat noise. When you miss a beat, you'll lose points. 

The important point from a programming perspective is the use of the IF line for the rhythm. This 
program was created at our office, and the cat and dog noises ended up really annoying everyone 


sitting nearby. 


4 Two columns of notes move up the screen. Press the A or B Button as 
they reach the top of the screen. 


Special Section Single-Screen Programming Corner 


Program List 


Ge CLEAR: CLS:R=68:P=69 
te @ START 

GEER GCLS & 

GMP IF ¢C%d5==8 THEN BEEP 31,4, 99 
GP IF ¢Cx85==d THEN BEEP 34,4, 99 
Gi BEEP 27, 4, 6d 

Gi C=C+1i:IF C215 THEN C=6 

GF ESBUTTON¢ 2: LOCATE 8,8: ?7"2:";55 
GER IF K==16 THEN DP=E 

Ge IF K==32 THEN NEI 

GE S=S+D+N: 2=0+N: D=D* 7: N=N*T 
GF TFC RK !=6 AND 2==83 THEN GOSUBGE 
GEER BEEP R,@,0:0=@:BEEP FP, @,N:N=6 
GE YSYHC 16:GOSUB @SCORE 

GER T=CHECHR¢ 26, @3:E=CHECHR¢ 2d, @3 
TH GOTO @START 

Ti @ SCORE 

GEER H=RND CSS: Y= CRN 238#d9+26 

GREP IF ¢Cx25!=8 THEN #=49 

GE IF «==@ THEN LOCATE ¥, 23: 7" " 
GER IF «!=6@ THEN LOCATE @,23:?7" " 
EEF RE TURH 

CHEER @E 

GER BEEP 8:5=S-16:GCLS 166:RETURN 


+The sound effect codes are assigned to variables R 
an 


The rhythm is created with a combination of 3 
instruments" 


+The process when the A Button is pressed. 
+The process when the B Button is pressed. 
+The calculation when you hit the beat and score 


points. 
+The subroutine that is initiated when you miss a beat. 


«The note coordinates — variable Y, display flag — 
variable X 


«This displays a note on the last line and makes it 
scroll. 


+The process when the player misses a beat. 
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You need to pay attention to lines 4-7, which deal with the rhythm. 
It's a combination of one instrument playing 16 times, another one 
playing 4 times, and another one playing twice. 


P 
E 
R 
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A Simple Action Game with Sprites and a Scrolling Background 


@ Introducing the Program 

The screen scrolls automatically from right to left, meaning you have to time your jumps correctly 
to clear the holes in the ground. The holes appear at random, so the difficulty varies, but there is 
bound to come a time when you find it too hard to handle. 
@ More About the Programmer 

I've been involved with computers for 27 years, since first learning BASIC on the Sord M65. After 
learning machine code and getting programming experience on the M5 and MSX2, | wrote for the 
Micon BASIC Magazine, introducing the readers to BASIC on the Sega Saturn and PlayStation 2, and 
writing articles about all aspects of programming. | still program to this day. 
@ How it Works 

When the program is run, it will wait for button input before the game begins. Press START and 
the action will get underway. Press any button to jump, and aim to clear the holes in the ground. Fall 
into one and it's game over. Your score is displayed in the top left, representing the distance you 
have covered. Press START at any point to restart the game. 


A The screen scrolls from right to left. 4 Mistime your jump and you will fall down one of the holes, and 
it will be game over. 


O08 


Special Section Single-Screen Programming Corner 


Program List 


0001 Bia 

Te PRINT "PUSH START" 

TEP FOR L=8 TO 1@2d4:L=BUTTON¢ 3 
TTF HEKRT: BGHPLAY 1i4d:5PCLFE:CLS ee ee Eee 
TE CLEAR: SPSET &, 64, 2,6, 6,4 

Ti SPANIN 8,4, 6:FOR I=8 TO 63 


P 
E 
R 
J 


NER Tp (sls its (lq 'Sifie Zs sl, (5) 8 ERs +The game's start point. The ground will be filled in. 

TE FOR L=8 TO 2:¥SYNC 1 ~The main loop. 

DHE A=H:IF RPNOC99331 THEN AL «Generates a random number. If the variable A = 1, the 
ground will remain the same. 

TEP EGPUT 8, 4#°8-1,46, 48,2, 6,4 +If variable A = 0, a hole in the ground will be generated. 


Te FH: IF Ytb OR J!=8 THEN Fel +If the character is in mid-air or mid-jump, the value 1 will 


be assigned to variable F. 


PEF TF BUTTOH¢ 3==8 THEH Fel -| fie Pulton i Biesseu, the value 1 will be assigned to 

CFER ITF F==8 THEN J=-8:BEEF & lf te vetioblel 14.0/ the oberaoter wil been HequRD. 

Te SPOFS 8,68, 7+88:BG0FS &, 4,416 

TE BGREADCS, X78+8, 83,01,H,P, ¥ | Hele tej sround wo selene verb ¢ 
hole in the ground will be assigned to variable C. 

TE BGREADC SH, (X#+737°8+8, 83,0,H, PP, ¥ Calculation for jump and drop. 


Te C=C1 ORF C 

EP YHEVYt I: JST+ CY Shee G-OY e HB eT 

TEP H=aet1: LOCATE @,8:PRINT «a } 

TEP IF C==356 OR Yeh THEH L=&:WEHXT  <'f there is no hole in the ground, or the character is mid- 
jump, this section will loop. 

TES BENSTOP: BEEP 6:FOR J=6 TO 13 

GE YHVY+ I: SPOFS 8,68, 7+88:¥S7YNC 1 

GEPHEST: SPCHR 8,88, 2,46, 6,4 

HEP GOTO 81 


The score (X coordinate of scrolling screen) is added 
up and displayed. 
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The Game Over process. 


This is impressive! It's a short program, but 
it still finds space for score-keeping and a 
game over process. 


The collision detection covers the lower central part of the 
player character. If there are 8 pixels open beneath him, he 
will fall and it's game over. 


The ground will become more and more riddled with holes, so in the end, 
you won't be able to get across, no matter how much you jump. If you 
modified this program to allow the player to move right and left. it could 
be a lot of fun. 
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A Game for Killing Time 


@ Introducing the Program 

When you've got time to kill, there are few things more satisfying than popping bubble wrap. This 
program was created with that same feeling in mind. The reason the same image appears on both the 
upper and lower screen is that the programmer wasn't sure how to detect the coordinates of the E 
on the Touch Screen. 
@ More About the Programmer 

| was born in 1965 which puts me right in the middle of the BASIC generation. At the time, | was 
content playing games created by other people, though | did give N-BASIC on the PC-8001 a try, but 
gave up when | came up against arrays. | attended some lectures on FORTRAN at university, but | 
still found arrays to be problematic and failed to get credit for the course. And that's where | stand 
today. 
@ How it Works 

There are many "EI" on the touch screen, and touch by the pen and delete them one by one. 

After clear, you can see the very little event(only one message is displayed). 


+ CLEAR&CLEAH! 


4 You'll find lots of smiley faces on the Touch Screen. Touch 4 When you make them all disappear, a message will be 
them with the stylus and they will pop and disappear. displayed. 


0070 


Special Section Single-Screen Programming Corner 


Program List 


P 

O00 Ibis eG ILS SIAL lel  Wiele Ss 
GT GPAGE 1:N=36:BDIN AKCHND, YONG + Assigns the number of symbols to variable M. T 
TEP Z=H:FOR T=8 TO WN-L i 
i @ RE 
DTS RC IS =RHDC SLI YC IN H=RAD C235 «Requests the coordinates for the symbol display. 
GE C=CHKECHR¢RCI3, ¥CI93 +f there is already a symbol in the same location, it will 

start the process again. 
Tw IF C==7T GOTO @RE 
ETP PNLSTR #HCI3, ¥C13,"86",6 «Displays characters on the lower screen. 
GREP LOCATE #H¢1I3, ¥CI3: ?7"6" : NEAT I + Displays characters on the upper screen. 
Tt @ TOUCH 
Te V=FLOORCTCHA P25 Be Seo ‘ 

Detects the coordinates of place screen was 
TH W=FLOORCTCHY “1928245 estes 


TFER IF TCHST==8 GOTO #@TOUCH +Waits until the screen is touched. 

GA IF CHECHR¢EY, W3!'=7 GOTO @TOUCH line SESS LOS Oe MAUI Poulin to ei eae: 
TER Z=24+1: FOR I=8 TO 2 

TH PHLSTR V,H, "#", 6 

TF LOCATE VW,H:PRIHT "#" :¥SYHC 3 
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TE PHLSTR VWiH," ", 

TEER LOCATE W,H:PRIHT " ":¥SYHC 3 

HEF HEAT I 

MEP IF 2£!=N GOTO #®TOUCH “alas have not been erased, it will return to an 
TE @ OW ARI 


GER LOCATE 49,49 
GERPRINT ".CLEAR& CLEAN! A" 


; Hey! | want to hear a nice popping 
( / 4) sound when | touch the smiley faces! 
Well. why don't you add it yourself? Maybe you could 
add a BEEP command between rows 14 and 15. 


This program uses array variables for X and 
Y coordinates, but | don't really think this is 
required. All you need is variables for X and Y. 


Seay 
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A Sound-Effect Sampler 


@ Introducing the Program 

This program resembles the first single-screen sample program we showed you, but the 
calculation process and the way it plays the sound effects are a little unpolished. It took about two 
days to create, including time spent learning how to use the software. The original idea was to 
mimic a Theremin, the electronic instrument that changes pitch as you move your hand closer to it. 
However, it ended up being something completely different. If the Touch Screen allowed detection in 
two different places at the same time, this program could have been designed to use two styluses, 
but alas, it wasn't meant to be... 
@ More About the Programmer 

| am 42 years old, and it's been 15 years since | last programmed with BASIC. I've loved fiddling 
around with machines since | was a child. | was really struck by the NEC single-board TK-80 and | 
learned BASIC on the NEC PC-8001/8801. My friends and | used to go to the local electric goods 
store and write silly programs on the computers there. | now work in sales in the IT industry, though 
my knowledge of the field remains stuck in the past. Still, | do my best to pretend | Know what I'm 
talking about... 
@ How it Works 

After the program starts, the code for the BEEP sound effect and interval between sound effects 
is set. When you slide the stylus along the Touch Screen, it plays the sound effect. If you slide the 
stylus upwards, the volume increases, while if you slide it to the right, it rises in tone. If you make 
circular motions with the stylus, it has a kind of vibrato effect. 


4¥0L UP+TONE UP 


a |f you select a percussion-style sound effect, and set a 4 Sliding the stylus from right to left will alter the pitch of the 
suitable interval between effects, you can create a great beat. note, while sliding it from top to bottom will change the volume. 


Special Section 


Program List 


Single-Screen Programming Corner 


Ge CLS: CLEAR: PNHLTYPE "OFF" 
GE PRINT "=== 3° #50 S55" 
EEF INPUT "WAVE HO." ; HAVE 
GH INPUT "WAIT TINE"; HTINE 
GE FRINT "" 
i PRINT " 
i @START 
GIF TCHST==TRUE THEN GOTO @CAL 
HEF GOTO @START 

He @ CAL 

GES TONES=¢TCHa#*6d 32-8192 

HEF WOLYL=FLOORC TCHY#127 41923 
GER YOLY2=ABS¢¥VOLYL-127 3 

TF BEEP WAVE, TONEA, YOLY2 

ee VSYHC WHTINE 

GOTO @START 


ae MOVL, WN SP apa, UN 


«Waveform number input (0-69) 


+Time period input (1-) 


«Creates sound effect when screen is touched. 


«Calculates the sound's pitch. 


|. Calculates the volume's pitch. 


+Plays sound effect. 


So will this program let you use the Touch Screen 
to shift the pitch of a sound effect up or down by a 
range of two full octaves? 
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Well, it's a bit complex, but the maximum value of the pitch formula on line 
11 cannot reach 8192 (2 octaves). But perhaps you could try adjusting it as 
follows: TONEX=((TCHX/255)* 16384) - 8192. What do you think, Prof? 


Hmmm... I'm afraid that's still not going to do it. It's tricky to touch the corners 
of the screen with the stylus, so it's hard for the returned value of TCHX to 
ever reach 255. It's a good idea to adjust the processing for the upper limit on 
inputted values to allow for larger values. 
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aes Ae 


A Program That's Like Watching Grass Grow 


@ Introducing the Program 

This environmentally-sound program lets you watch grass grow on the screen. 
@ More About the Programmer 

Many years ago, when | was a student, | had my programs published in a BASIC magazine. 
Compared to the trouble | had programming with the 8 colors available on the Sharp X1, Petit 
Computer was a breeze. There are all sorts of shades of green, for instance, which really impressed 
me. | think this comes across in my program. 
@ How it Works 

Press the A Button to select ‘Earth’, the B Button to select 'Water', or the X Button to select 
‘Concrete’. Touch the lower screen to place the selected item on the screen. When you place earth 
on the screen, grass will grow, letting you sculpt your own lawn. 


Position earth on the Touch Screen and grass will grow from Wait a while and the grass will cover the screen. There are no 
it. particular surprises in store beyond that. 


Special Section Single-Screen Programming Corner 


Program List 


Ge CLS:PNHLTYPE "OFF": BGHPLAY 26 
Gee CA=7T:CB=d:CC=13:C=CA 

GEER GPAGE 1:GCLS5 

Go @hHAlH 

ie YSvyHe 1 

GF S=RNDC 2569: Y=RNDCLI2S 

Ge H=8:Ce=GSPOTTCa, Ya 

Ge IF Cx==CA THEN N=RNDC do +1 
MEF FOR I=i TO WH 

GE T=RADC225+RNDC 9G 3 3 

GER R=RHDC63+6 

GER Cee 2dl-CRND C55 #6 3 

GEER H2EKR+tCOSC TARR: Y2ZST+SINC TOR 
GEER GLINE #&, 7, a2, 72, C8 

CHEER HE & T 

GE B=BUTTON¢>:IF & THEN BEEP 5 
GF TF B==16 THEN C=CA 

GEER TF B==32 THEN C=CE 

GEER TF B==6d THEN C=CC 

GE IF TCHST==6 THEN @hHAIN 

Ge S=TCHa: Y=TCHY: BEEP 38 

GEER Lae HB a 2eate VLE -S: VY 2748 
GER GFILL al, ¥1, 42, 72,C 

GER GOTO ¢haArh 


+Settings for the color code. 


+ Obtains color code with random coordinates. 

«lf earth has been placed on the screen, grass will grow. 

«Variable N represents the number of blades of grass. 

«Variable T represents the angle at which the grass grows. 

«Variable R represents the length of the grass. 

+Variable CX represents the color of the grass (65 shades 
of green). 


+Draws grass. 


+Selects earth. 
+Selects water. 


+Selects concrete. 


+Draws image on screen. 
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? Um... So what exactly is the 
( / 4) point of this program? 


Hmmm... It would have been nice to have a 
few more game elements, such as more grass 
growing near water. 


© 


This reminds me - someone was working on a 


program that filled the screen with fingerprints, but 
they ended up abandoning it. 
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~ Petit Computer Programming Tips ~ 


A Smart Approach to Programming 


Let's begin by identifying some particular problems you may encounter when programming with 
Petit Computer. 


-You weren't really sure what to write, and a line in your program has got really long. You have ended up 
confused as to what this or that particular part of the line does. 

- The order that operations and processes take place has become really confused. You have come up with what 
you might call 'spaghetti code’. 

~The characters have extended to the right edge of the screen, and they're hard to read. Each line in Petit 
Computer is 32 characters long. When | exceed that line length, | have to scroll character by character to read 


more. 


Here we will introduce you to some special methods for writing programs in order to avoid 
problems like this. 


@ Abbreviation and Omission of 


Characters 
: How to program 
It's good to keep lines as short as 
possible so that they are easy to read on "ABC" “Abbreviating PRINT commands to ? 


screen. This will mean you won't have to 
scroll sideways to read programs. 


IF A THEH #@HAIN ~<omitting GoTo 


@Use Subroutines 


Divide programs up into manageable 
segments. Rather than writing long lines 
with very intricate processes, create GOSUE @Suedi 
separate sections that carry out the GOSUB @sup? 
desired operations. You can then use 
GOSUB commands to go straight to these 
subroutines, making the whole way the 
program operates smoother and easier to 
grasp. 


@ Avoid Using GOTO Wherever 
Possible ® 


On Petit Computer, you cannot use ELSE 


How to program 


How to program 


commends after IF ~ THEN, so try this IF @==8 THEN GOSUB @SUBL 
alternative. IF A==1 THEN GOSUB @SUB2 


Extra! A Smart Approach to Programming 


@ Avoid Using GOTO Wherever Possible ® 

Depending on the values you input when using conditional branching in your program, it may be easiest to 
use ON~GOSUB commands to fit the operation on a single line. This will keep things shorter than using an IF~ 
GOTO command and listing the different operations, and will make the program clearer to read. 


wat 


How to program 


OH A GOSUB @SUB1, ¢S5UB2 «If value of A is 0, go to SUB1. If it is 1, go to SUB2. 


@Leave Notes 
Make notes in each section of the program so that you can look back and see clearly what each line does. 


How to program 


o pee «The text after the apostrophe is a comment, and will not affect 
ao ag bao the operation of the program itself. 


There are ther ways of preventing lines in your program from getting too long and requiring 
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you to scroll. These include avoiding long variable names, and avoiding the use of indentation. This 
may seem out of step with the way things are done nowadays, but it's a good way of keeping your 
programs in Petit Computer nice and clear. 


Image:Kuri Hiroshi 
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Stars of BASIC@ 
Dento Teramachi 


| was the foolish kid cutting class on the 8th of every month so he could read the latest issue 


of my favorite BASIC magazine in the book store. 


My friends and | whiled away our youths listening to our favorite singers and trying to cut out 
all the IF codes we could. | remember watching agog as someone put together a routine using 


about six sets of brackets, and managed to get an 
airship moving in eight directions with a single line 
of code. 

‘How on earth did you manage that?' 

‘| just gave it a try, and came up with this.’ 

So it was BASIC that taught me the true 
meaning of the word envy. 


Dento Teramachi runs a website called Classic 
Videogame Station Odyssey (http://www.ne.jp/asahi/ 
cvs/odyssey/). 

Looking at the site, the links between the latest 
games machines like the Nintendo 3DS and old versions 
of BASIC can be traced. 

Working under the pen name Fu-San, Teramachi 
was an illustrator and contributed popular programs to 
'Micom BASIC Magazine’. 


Git qa 


A The Classic Videogame Station Odyssey homepage. It is 
a treasure trove for fans of vintage gaming. 


Stars of BASIC® 
Yukihiko Tani(Bug Taro) 


During the first home computing boom, | was in my second year of junior high school. | remember visiting 
the electronic department in the big stores and being able to get my hands on the display models from all 
the main manufacturers. For someone like me who loved computers but had no hope of affording one, it was 


a dream come true. 

At the time, BASIC would start when you booted up 
most computers. 

This meant that almost everyone had a working 
knowledge of BASIC. 

| remember my friends and | would all imagine that 
we could master BASIC and then port across any arcade 
game we liked to our home computers. We were being a 
little over-optimistic there... 

Now, with Petit Computer | think you really could 
port the arcade games of the 80s across! 


Yukihiko Tani began programming when he was in junior 
high school and his programs subsequently appeared in My 
Con BASIC Magazine (Dempa Shinbunsha) under his pen-name 
Bug-Taro. His programs pushed the technical boundaries of 
the time and proved to be exceptionally popular with readers. 
He went on to work for a game development company and 
has been involved in creating a huge number of games. He is 
now the CEO of Next Entertainment Co. 


Hrultrire 
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AFull-Fire, a program that appeared in October 1990. The 
image is taken from a publication on the NEC 8-bit PC- 
8001 and PC-6001. 
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Creating the Graphics You Want 


Roe Mh ¢ 


In Part 3, we looked at the basics of Petit Computer, 
including how to create graphics. Petit Computer has 
graphical capabilities that older versions of BASIC did 
not have, letting you position sprites freely, use the BG 
function to fill the screen with colorful backgrounds, and 
giving you tools to create characters. In this section, we 


i will look at these functions in more detail. 

Z NE 4-1 Layering Characters & Backgrounds sr: HT} 

I F d - | 2 Getting to Grips With the ToolScrrrrrcrcsceececeseeteteeeeceseeeeenees 

IE. 

GOT! Special Section 100-Line Programming Corner <r: GEL 
NEW Extra! Other Ways to Use Petit Computer :--1-1+ 04 


The PCG Editor that came with Hu-BASIC on { 
the Sharp X1 was programmed using BASIC. 
Gah! Stop talking about 
the olden days, will you! 


TNH 
Se oT 


One of the innovative things about Petit 
Computer is that the tools included with it are 
also programmed in BASIC. 
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% The Sharp X1 was released in Japan in 1982 and had a 
character programming function or PCG. 
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tease Layering Characters & Backgrounds 


With Petit Computer, it's easy to create a scrolling background with characters moving freely on 
top of it. In this section, we'll take a look at how to program characters and backgrounds. 


The screen display in Petit Computer is made up of a total of 5 different elements: the console 
screen/keyboard, the user BG screens, the sprites, the graphic screen, and the background color. 
Each of these elements is suited to 


different uses, with sprites being ideal for background color 
the graphic screen 
the rear BG screen 


game character display, and the BG screen 


being designed for the background display. 


the front BG screen 


Front 


The first layer of the display on the upper 


the console screen (upper ) 
keyboard (lower) 


screen is the console screen, which the first (max 100) ek 


layer on the lower screen is the keyboard. 
It is important to understand how the 
different components of the display all fit 


together, particularly when learning how to 


program sprites and backgrounds. 4 The display consists of the following five elements (from back to 
ront): background color, the graphic screen, the rear BG screen, the 
ront BG screen, and the console screen. 


The sprite function lets you display characters on the screen, and allows you to move a large 
number of characters smoothly. 

The SPOFS command is used to assign coordinates to sprites and display them. The upper and 
lower screens can each display up to 100 sprites. Each sprite can be up to 16x16 pixels in size, and 
can be one of 16 colors. You can select from a total of 16 palettes. For an overview of the palettes 
available, see page 10 of the Petit Computer Resources (Graphics) section. 

The sprite function can also be used to display animated 
characters. The SPANIM command is used for animation, and 


allows you to assign character numbers which can be switched 
between in the on-screen display. 


For example, by switching 
between the characters shown 
above, which have character 
numbers of 68-69-7071, you 
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X Coordinate 
: 512 pixels (64BG) : 


Defining coordinates 
with a SPOFS 
command 


BAL 


can create an animated image of < (512 
. o bixelsW 
someone walking. Use the program 9 (64BG) 
bal 
below to make this character walk. $ 
iv} 
The SPANIM command lets you 6 | 
set the character numbers to be ; 
511.--- 16X16 pixels 


switched between. 


Each sprite can be up to 16x16 pixels in size. The coordinates for the sprite's 
ocation are set using the SPOFS command. 


EXAMPLE 4-01: Animating a Sprite 


oe CLEAR 
MT DIM KOS29, 7O329 


quem no, soiydesy ou) Suneeg 


PEF CLS 

TE SPPAGE & 

Tie SPCLE 

FOR I=8 TO 31 

rete |=) tle iscebe Me ale [Sle +This is the initial sprite setting. 

SPANIN I,4, 148 «This is the animation display 

atTa= Tee This 3 the initial coordinate 
setting. 


0010 a ae ee =) 

001] Bale 

Te @ MATH 

EPFOR IT=6 TO 31 

GP IF RNOC2) THEN YeTae¥eTat+l 
OEP IF YCIse191L THEN Yels=6 
MHP SPOFS I, 4¢15, ¥O13 

0017 Bal ae 

TEP IF BUTTON*3==6 THEN ¥SYHC 1 
EF GOTO @haAlb 


<The process is repeated from 0 
oil 


<The probability for sprite 
movement is set at 50% 


«This causes the sprites to move. 


When the program is run, 32 individual sprites will 
travel downwards to the bottom of the screen. Each 
character is animated so that it walks and moves its 
arms. Press SELECT to speed up the sprite movement. 
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Petit Computer includes a large number of sample characters which can be animated, so have fun 


experimenting with them all. 


Processes Using Random Numbers 


In the example program 4-01 shown above, the sprites have a 50% chance of moving. By 
using a RND function, you can generate a number at random. So for instance, IF RND(2) THEN~ 
will mean that a process has a fifty-fifty chance of occurring. 


A Program with a 50% Probability 


IF RND ¢25 THEN 9090000 


«Enter the operation to take place if NO. 


You can select the location where 
you wish sprites to be displayed. These 
locations include the front of the console 
screen, the front of BG screen O, on the 
console screen, and more. When two or 
more sprites are displayed in the same 
location and their positions overlap, the 
one with the lowest assigned control 
number will be displayed on top. You can 
assign control numbers of 0-99 to sprites. 

One of the special functions related 
to sprites is that using control number 
0-31, you can scale or rotate sprites. If 
you want to shrink or enlarge a sprite, 
use the SPSCALE command, selecting a 
scaling ration of between 0-200%. If you 
want to rotate a sprite, use the SPANGLE 
command, which lets you turn the sprite 
between 0-359 ° 
sprites are turned is at the top left of the 


. The axis on which 


sprite. See the image for an example of a 
sprite being rotated by 30°. 


The sprite with the lowest control 
number will be displayed at the front. 


A When sprites are displayed on the same screen and overlap, the sprite with 
he lowest control number will appear on top. 


control number O control number 1 


Defining coordinates 
with a SPOFS command 


If SPSCALE command 
function is 50 Bis 


If SPSCALE command 
function is 100 = 


If SPSCALE comman 
function is 200 —s 


Sprite 
control number 0~ 31 


A The axis around which sprites are rotated with the SPANGLE command, 
or scaled using the SPOFS command is set at the top left corner. 
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Use these functions to make fun programs which have plenty going on. The program below shows 
you how to move the axis around which a sprite rotates to the center of that sprite. It uses SIN and 
COS trigonometric functions to make it appear that the axis has moved to the center. Try using it in 


BAAD 


your own programs. 


EXAMPLE 4-02: Rotating and Scaling Sprites 


Lees Less +Clears all graphics. 

PTE GCIRCLE 1278, 96, 26,15 Draws a circle. 

TEER PHLTYPE "OFF" +Deletes the keyboard on the lower screen. 
THF SPPAGE & 

te SPCLE 

4=128:7=168:PaAT=68:PAL=2  <Sets coordinates and character number. 
SPSET &, PAT; PAL; 8B, 8, 8 +This is the initial sprite setting. 

THE SPANIN &,4, 38 +This is the animation display setting. 
CER @ MATH 

D=TCH# +Enter angle of rotation. 

Tie S=TCHY +Enter rate of scaling. 

Tne CLS 

TEER PRIHT "KARUGO=";0 

THF PRINT "SCALE=";5 

TEP A=RADCCO+2259% 36eo 

TH R= SeS°1LABe SOR CSS 


quem no, soiydesy ou) Suneeig 


AL=COSC AIR «Calculates amount of movement on x-axis at top left . 
YL=SINCAI#¥R «Calculates amount of movement on y-axis at top left 
TEER SPANHGLE 8,0 «This sets the angle of rotation. 

HEF SPSCALE 4,5 «This sets the rate of scaling. 

SPO ss (Slo aisreydba part db Sela: and displays the sprite movement in 
TE VSYHE 1 Waits. 


HEP GOTO #@haArh 


When the program is run, a single sprite will be 
displayed in the center of the screen. Depending on 
the commands entered on the Touch Screen, it will get 
bigger or smaller, and rotate. Moving the stylus to the 
left or right will cause the sprite to rotate, while moving 
it up or down will shrink or enlarge it. The sprite's angle | 


and scale are displayed in the top left of the screen. The 
sprite moves on its own, making it fun to watch. il 


® | 


A Screen when Program is Run(EXAMPLE4-02) 
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BG screen is short for 'background screen’, 


X Coordinate 


and it refers to a function that is chiefly used o— Gas.  — Sst 

for background display. The BG screen has two ° 
: | Defining coordinates 

overlapping layers numbered 0O (the front layer) with BGOFS command 


and 1 (the back layer). You can design and move 512 é 
a pixels BG display range 
each of these layers independently of the other. g (6430) es nae Single character is 
a 8x8 pixels 
The same BG screen function can be used on FA 
oO 


both the upper and lower screens. | 
The BG screen is 512x512 pixels in size, and 


you can arrange characters on the screen in 8 
pixel units. The display area is set at 256x192 


pixels, though this can be modified using a 
BGCLIP command. 

The BG screen is designed so that the top 
and bottom of the screen are connected, as are 
the left and right edges. This means that if you 
have a continuous image extending beyond the 
display area, you can make it scroll to appear 
that there is no limit to the background. 


BG screen 


Here is an example of a program that causes 


the BG screen to scroll. 4 As both edges of the screen display are connected, the 
background will scroll on a continuous loop. 


Scrolling on the BG Screen: program 4-03. 


Ti} BGFAGE & 

TER BGCLIP &, 4, 31, 23 «Sets size of display area. 

TER PAL=8 «Palette number. 

tt L = «Select BGO. 

Tt FOR C=8 TO 1423 

BarCk 32 «Assign the remainder from C+382. 
BY=FLOOR¢C 4325 «Assign integer value from C+ 32. 
HF BGPUT L, BX, BY, C, PAL; &, & +«Drawcharacter. 

HE#T 

Te A=: Y=8 «Coordinates of display area. 
i} @hATH 

HEF B=BUTTONS 3 + Button input. 


* To Next Page * 
08u 
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CORE IF 
Cote IF 


ANG THEH Y=¥-1 +Loop coordinates. 
AD THEN YH¥+1 

CEP IF AHD THEN #ee#-1 

0015 AHO 8 THEM #=K+1 

Te A= AND 511:7=7 AND 511 + Set coordinates. 
SEO rs (be tie + Display coordinates. 
[e|L is 

TEP PRINT "A=" 585", YE" GT 
Tee YS YH 1 Wait. 
TE GOTO @hHAIn 


nom om 
Bh 
RAAT 


When the program is run, BG characters will be displayed 
on BG screen O on the upper screen. The X and Y coordinates 
assigned using the BGOFS command will be displayed on the 
top left of the screen. By pressing up, down, left or right on the 
+Control Pad, you can cause the BG screen to scroll in that 


quem no, soiydesy ou) Suneeg 


direction. There is nothing programed to be displayed on BG 
screen 1 which is at the back, so it will remain black. 


In this section, we will use what we have learned so far to create graphics by layering the 
console screen, graphic screen, BG screens, and sprites. 


EXAMPLE 4-04: BG Screen Scrolling 


Jono es Le tbe abe abe aba abe al 

[0b | Ye SSS SSS SSS SS SS SSeS GRAPH — <Display on graphic screen. 
TER GCLS 

TTF FOR I=1 TO 586 ; 
TEP R=RHOCSG6Bs  YHRHD C256 4 Graphics (from back 
TT GLINE 125, 96, 4%, 7, RHBC2563 of screen) 
CT HE a T 

SSS ae ee ee ee eS Boa «Display on BG screen 0. 
HTER PAL=38 

TA L=@:4=15:C=51i2+ds 

THe FOR Y=18 TO 13 +Display chimney character. 
TEP BGPUT L, # a ite UE bes [sls 18! 

TEER BGPUT L, #+1, 7, C+1, PAL, 4, @ 

TH C=C+32 


4BG screen 0 (front) 


* To Next Page * 
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MRE Sta SS ri Si ai ai Bol «Draw image on BG1 
a L=1 

TEP FOR Y=1e8 TO 21 

TEER FOR #=d Viel 2 <Display grass on BG screen 
HE C=S2+RHDC 23 

Tee BGPUT L, &#, 7, C, PAL, @, & 


[Og hd et Nd el ht SPRITE +-Sprite settings. 
EEF SPCLE ABG screen 1 (rear) 
HE H=128:7%=6d:PAL=2 

TEP SPSET 8,65, PAL, 8, @, 2 «Hero character settings. 
HEF SPOFS &, 4, 7 

HEF SPSCALE @, 244 


00) P BSS SSS SSS eSeooSSeers CONSOLE Display on console screen. 
TE CLS 
TER FOR T=%H28 TO &HTF <Display characters as test. 


EEF LOCATE I48, FLOOR¢CI/&3 

EDP PR IHT CHR#¢ 1a 

CHEER HE aT 

JE) BSS SSS SSS SSS SS SSS55 CHANGE NOD E-Wwait for button input. 
CLEP 11 = & 

TEER @ MATH 

GEER IF BUTTON®2==8 THEN @HAIH 


A Sprite 


TTP N= CN+19%6 «Loop within range 0-5. 
Toe IF H== THER eT Se BIE ay a lle dae ds) switchibetween 

screen display. 
Te IF H== Winllelnl Wrst leis abe (als Isl. [Shp tle 15) 
EF ITF H== THEH VISIBLE 8, 4,1,6, 4, 6 
Ti IF H== Wine lh) MeL IS [le (ahs (she abe isle 15) 
oTEe IF == Winllein) WS IEE (ale Ile [ils Wale abe (5) 
Tt IF H== Wine lh) Mee LIS [le (als 18h Wile ile ab 

Console (screen front) 

Te YSvYHC 38 «Wait. 


GOTO @MAIN 


The screenshot on the right shows the program when it is running. As you can see, a complex 
array of images has been built up by layering the different display 
elements. This process allows you to create an image such as this 
one, where the hero character is passing behind an obstacle. 

By pressing any button, with the exception of SELECT, you can 
switch the display as follows: console screen — BG screen O —> 
BG screen 1 > Sprite > graphic screen — all screens. It's fun to 
see which images are displayed on each screen. 


4 Put them all together and... 


4-2 Getting to Grips with the Tools 


Getting to Grips with the Tools 


There are three graphic tools included in Petit Computer: a character editor, a BG screen editor, 


and a graphic editor. These are all large-scale programs created using BASIC. You can make use of 
these tools to create your own characters and backgrounds and display them in your own programs. 


Before looking at each of The kind of files | The name of Resources) Contents 


these tools in detail, let's look at PRG PRG Program 
the resources available to you. MEM MEM Memory 
o. . COL COLO~COL2 
In addition to loading GRP GRPO~GRP1 Graphics (O=Upper Screen, 1=Lower Screen) 
programs, Petit Computer SCR SCUO~SCUt1 User BG screens (O=front. 1=rear) 
CHR BGUO~ BGU3 User BG characters (bank 0~ 3) 
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also allows you to load files 


SPUO~SPU7 User sprite character (bank O~ 7) 


containing characters and much 
more. By using the LOAD and SAVE commands along with "Resource Name: File Name", you can 
gain access to a wealth of resources. See the table above for an overview of the types of resource 
available. 

You can use the three editing tools we will look at below to create graphic and BG screens, 
as well as character files. All of these can be saved so that they can be later loaded and used as 
resources in your own programs. 


Saving and Loading MEM Resources 


There are other resources besides program and graphic resources which can be saved and loaded in 
file form. In this section, we will look at one of these resources, a memory (MEM) program that allows data 
to be saved and loaded. In the example below, the number of times you run a program will be counted. 


EXAMPLE4-05 : Counter will be stored even after you switch the power off. 


The LOAD "HEN: NENCHT" = ons Maes contents will be stored to the 
variable ; 

TER C=VALCNEN#34+1 <The contents will be converted into numerical 
form, 1 will be added and assigned to variable C. 

TEP PRINT "2" 51399n4¢29 "3 Displays total number of times program has been 


TE HENS=STRECCS SEES a character string to variable MEMS. 
TE SAVE "NEN: HENCHT" +Saves MEM$ as a file. 


When this program is run, the total number of times it has been run will be displayed on the screen. This total will be 
saved as a file, meaning that it will be stored even after you switch the power off. By making use of this function, you 
can keep records of high scores on games you create. A confirmation dialog box is displayed each time a LOAD or 
SAVE command is used, and this may get tiresome after a while. You can enter LOAD "MEM:MEMCNT"O to reduce the 
number of dialogue boxes displayed by one. 


PART4 Creating the Graphics You Want 


Character Editor lets you create characters to be used on BG screens or as sprites. 


There is a huge variety of character data pre-loaded onto Petit Computer, but if you want to 


create your own original games, it's likely that you'll want the freedom to design your own characters, 


and that's where this tool comes in. 


When Petit Computer was first released, there was a bug which did not allow users to save 


resources. However this bug was fixed on the Petit Computer ver.1.1 update released in Japan on 


16th June 2011 which included the latest character editor. 


How to Use This Tool 


The file name for this tool is CHRED. Enter the following command in Run Mode to run the tool. 


EXEC" CHREB" 


The screen display 


(—+) fos Fags! 
a 
1 
: 
88) come 


® (GEEEEEED) + 


BEE 


PEN 


O;l.820.080.66,68) (i iso 


Button Controls 


A Button: Go to file menu 
+Control Pad:Move edit area 


@: 
®@: 


©8eoO Oo 


© 


The entire character set in a single bank will be displayed. The 
flashing frame indicates your currently selected character. 

Select the type of character you want to work on. Touch the screen 
to switch between the different types. 

[BU] «BG screen characters 

[BG] ---Sprite characters 


: The edit area is 16x16 pixels. Use the Touch Screen to draw in it. 
: The currently selected bank of characters. BG screen banks will 


display 0-3, while sprite banks will display 0-7. 


: RGB value of the selected color. Touch to change. 

: Color samples with color codes of 0-15. Touch to select. 
: Color palettes 0-15. Touch to select. 

: Tool selection. Touch to change. 


[PEN] ---Draw with stylus. 
[PAINT] «Fill. 


‘If you have used this command to animate a character, you can see 


the order of the character display here. Touch x and y to set the 
number of times a character is displayed, touch c to set the number 
of characters, and touch w to adjust display timing. 


Y Button : Delete character you're working on in 
edit area 


4-2 Getting to Grips with the Tools 


File Menu 


[TL GaJ : Load CHR file and display as bank you're currently editing 
TS GJ : Save character you're drawing along with its bank as CHR file 
[LC GJ : Load COL file and set as color palette 

[SC GaJ : Save color palette as COL file 

[Qa] : Close menu and go back 

TE G3] : End program 


Creating a Character 


2 16 
H80.080.60.e8 00 
aRefer to @ in the previous diagram and 4 Select the character you wish to work 
choose whether to work on a BG or sprite on from @ and then start drawing. 
character. Select the color palette you 
wish to work on by referring to @. 


Saving Characters 


Stliewttieweree 


M2soo 


RWIVICCHR): ? 


4 Press the A Button to access the file 
menu and use the S command to enter 
a file name and save. If you have created 
your own colors with ®, use an SC 
command to save your palette. 


By entering an S command or an MCHR command, character data will be saved in this 


format: "CHR:MYCHR". 


If you wish to load this as a BG screen character on the upper screen (bank O), run the following 


command: 


LOAD "BGUB:NYCHR" @ 


If you wish to load it as a sprite character on the upper screen (bank OQ), run the following 


command: 


LOAD "SPUG:NYCHR" to using the LOAD command. 


If you are having trouble loading data, run SPPAGE 0 prior 


When you run the LOAD command, the character data in the file will be set. You can then use 


CHRED to confirm how the loaded character data will be displayed. 


It can be fun to play around with existing game character data and see how you can adapt it. 


quem no, soiydesy ou) Suneeg 


F 
A 
R 
T 
d 
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This tool lets you place characters on the BG screen and create backgrounds for your games 
and other programs. Having the right background can make a big difference in the feel of role-playing 
games or shooting games. This tool is sure to prove invaluable when you are creating your own 
games. 


How to Use This Tool 


The file name for this tool is CHRED. Enter the following command in Run Mode to run the tool. 


ExEC "SCREDB" 


When you run this tool, the following question is displayed: 


FrAaFasIsIencyrna? 


To use character data you have created yourself, select Y and then enter the data file name. 


If you don't wish to use your own data, select N and get started with the editing tool. 


Display Structure 


@: This is a sample of a BG character. Edit Screen Menu Screen 
A bank of characters are displayed in 
the edit screen menu. 

@: The edit area. Touch this to copy it to 
the BG screen. 

@®: BG character banks. Touch to select. 

@®: Color palettes 0-15. Touch to select. 

®: Switch between layers of BG screen 
display 

®: Rotate vertically and horizontally. 
The orange color indicates that this @ 
function is being used. 


Button Controls 


X Button : Switch to menu and edit screen A Button(Menu Screen) : Go to file menu 
B Button(Edit Screen) : Display grid R Button&+Control Pad: Modify copy area 
+Control Pad(Edit Screen) : Move edit area Y Button: Select front or rear BG screen 


4-2 Getting to Grips with the Tools 


File Menu 


[L Ga] : Load an SCR file and display it on the upper BG screen, as the layer being edited 
[LW (a] : Load two SCR files and display on the upper BG screen, as BG screens 0 and 1 
['S (J : Save the BG screen currently being edited on the upper screen as an SCR file 
[SW (43)] : Save both BG screens O and 1 on the upper screen as SCR files 
[COL Ga] : Load a COL file and set as color palette on BG screen 

[CHR G3] : Load a CHR file an set as character on BG screen 

[QGaJ : Close menu and go back 

TE GaJ : End program 


How to Create a BG Screen 


ASelect whether to edit the front or back 4 Press the X Button to go to the edit 4 On the menu screen, press the A 
BG screen and select the characters you screen. Use the edit area to draw or Button to go the file menu. Use the S 
wish to use. modify characters. command to enter the file name and save. 

If you have edited both the front and rear 


BG screens, you can use the SW 
7 . command to save both screens. 
@Tips on Drawing 


The background is made up of two separate BG screen layers, which are laid over each other. By placing 
a character on the front layer, and then place a character behind it on the rear layer. This can be made to look 
like the rear character is hiding behind the one at the front. 

You can use each layer of the background in different ways. For instance, you could place tree trunks or 
leaves on the front screen, and grass on the rear screen. If you then place sprites in between the two screens, 
it can look like the player character is hiding amongst the undergrowth. 


Saving BG Screen Data 


When you enter S or MYSC commands on the file menu, the screen data will be saved to 


an "SCR:MYSC' file. 
If you wish to load this to BG screen O on the upper screen, run the following command: 


BGPAGE & 
LOAD" SCuUB:NYSC" 


When the LOAD command has run successfully, the contents of the file will be displayed on the 
upper screen. If nothing is displayed on the screen, it may be because the BG screen is not allowed 
to be displayed. In this case, try running the following command: 


Wiha i eikS abe abe abe als al. al(m 
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PAFRT4 Creating the Graphics You Want 


There are limits to how much can be achieved by using program commands to draw images on 
the graphic screen. By limiting yourself to setting coordinates and drawing lines and curves, it can 
be very tough to come up with a program with impressive visuals. This is where the Graphic Editor 
comes in. You can make full use of its drawing tools, or hand-draw images and then save the results 
in a file. 


How to Use This Tool 


To load the tool, run the following command: 


ExEC "GRPEB" 


After running this command, or when you leave the file menu, the following question will be 
displayed: 


NY systyeea2neB=V7ES> 


Press the A Button to clear the screen. If you press any other button, you will continue with the 
lower screen display unchanged. When you wish to start with a blank canvas, be sure to press the A 
Button. 


The screen display GRAPHIC EDITOR v1.6 


@: Tool. Press the X Button to select 


p 
ie 
A é B 
Draw a point Draw a line Draw a square C 
Draw a circle Paint area one color Fill rectangle ELS 
Erase everything on screen co -PSETIPEN> 


@:Pen size. Select with Y Button 

@®: Edit area. Touch the screen or slide stylus to draw. 

@®: Color samples. Select with +Control Pad. The flashing 
frame indicates the selected color. The color code (O- 
255) and R, G, and B value is displayed below. 


Button Controls 


X Button : Switch tools 

Y Button: Switch pen size 

+Control Pad: Choose from 256 colors 
R Button: Grid display ON/OFF 

A Button: Switch to file menu 


4-2 Getting to Grips with the Tools 


File Menu 


When you press the A Button to open the file menu, you will be asked whether or not you wish 
to copy your image to the upper screen. 


P 
A 
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Enter Y to copy the graphic image on the lower screen to the top screen. 


Enter N to continue to the file menu without copying the image. 


[LG] : Loads GFP files to the graphic screen on the lower screen. 

[SG] : Saves the graphics on the lower screen to a GRP file. 

[LCG] :Loads COL file and sets it as the color palette when 
creating graphic images. 

[SCGaJ : Save graphic color palette to a COL file. 

[QGa] : Exit menu and go back. 

TEGJJ : End program. 

x After leaving the file menu, you will be asked the same question that appeared when you accessed it. 


How to Create a Graphic Screen 
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MOON 


Press the X Button to select tools from 4 Press the R Button to display the grid, 4 Press the A Button to access the file 
@®, and the Y Button to select thickness giving you more precision when drawing. menu and use the S command to enter 
rom @). Use the +Contro!l Pad to select a file name and save. 


rom @ and start to draw. 


Saving Graphic Data 


Entering S or MYGRP on the file menu will save your graphic data in a "GRP:MYGRP" 
format. 
If you wish to display this graphic data on the upper screen, run the following command: 


LOAD" GRPS#:NYGRP" 


When the LOAD command has run successfully, the contents of the file will be displayed on the 
upper screen. If you wish to display it on the lower screen, change GRPO to GRP1 in the command 
above. 


PAFRT4 Creating the Graphics You Want 


Special Section 


VAVAVAVAVAVAVAVAVAVAVAVAV AV AV AV AV a YT AV 


What Can You Create in a Limited Space? 


#. 100-Line Programming Corner 


AVAVAV AV AV AV AV AV AV AV AV AV AV AV AV AV AV AY & 


Following on from the Single-Screen 


: ‘ So with 100 lines to play with, 
Programming Corner that began on page 64, we're e voll havesfour tines yee 
F . than the single-screen programs 
now going to take up the gauntlet of programming ayia lowlaeal eu eels 
within a limitation of 100 lines. Even within these 


limitations, you can come up with programs that have 


= Right. And you can use that space to 
the flavor and feel of the classic BASIC programs of raleia zac larger oct ee AG a< 
the 1980s. In the following section, we will introduce intricate. It's a nice way to get the old iN 
brain cells working. 


three programs which the author of this guide came 
up with. 


Race a Space Craft and Aim for the Fastest Time 


@ Introducing the Program 
This game is set in the zero gravity conditions of space. The direction your space craft will fly 


° 


is governed by inertia. One nice feature of this game is that the screen will scroll 360 ° in every 
direction. 
@ How it Works 

You will fly your craft round the zero-gravity track. Pressing left and right on the +Control Pad 
will alter your direction, while pressing the A Button will cause you to accelerate. Your lap time 
is displayed each time you complete a circuit of the track, and your aim is to set an unbeatable 


personal best. 


Special Section 100-Line Programming Corner 


Program List 


P 
A 
ne eee GER Oo Fi 
Tr CLS I 
ME CLEAR: DIM M8) 
TM H$cao="~ | 


TE HFcis=-" AEE i" 
H#c255" BREE 
H$c3o5" BREE 
H$cdo-" BREE? 
ME He¢5>=" NEW 4m" 
GP HFC =" AEE" 
O11 eo | | | | | | | 


Track data 


TEER BGPAGE & 

Ty L=4 

Te FOR Y=8 TO T 

Tt FOR H=8 TO T 

HP CH=ASCCMNIDEC NSC yYo, KH, 193 

TE CHRREADSC"BGFa",C3, BFS +Read font data. 
TEP FOR J=8 TO T 

HEF FOR I=8 TO T 

TEP A=VALC" BH" +NIDFCBF#, 1+3#8, 1393 

TEP BRET +HK SO BY ST+7 es 

EEF C=RHDCd9+36353:PALH11 

HEP IF A THEN CHRNDCdo +378: PALHS 

HEF BGPUT L, Be, BY, C, PAL, 4,48 + Draw background. 
CE HE &T 

TE HE &T 

EER HE & T 

TEER HE &T 

HEM C=12 

EW FOR BRe2d TO 31 

HEF FOR BY=8 TO T 
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TEER BGPUT L, Ba, BY, C, PAL, &, & +Fill the section of track where the 
HELP HE # T finish line is located. 

GEER HE & T 

0035} # SSS See PLAYER INIT 

HE PAL=2 


GEER SPPAGE &:SPCLR 

GEER SPSET &, 176, PAL, @, @, 1 
GM SPSET 1, 251, PAL, @, @,1 
Ge R=S*SUR C2 > 

Gir 2=8:F=1:T1=6 

GER H=1268:YS32: e156: 71=6 


* To Next Page * 


} Initial sprite setting 


PAFRT4 Creating the Graphics You Want 


PEF A=186:AL1=2:5NAa=8 +Variable A1 is degree of rotation. Variable 
[OWS ee HAIN SMAX is the maximum speed. 

i @hAIH 

Ht B=BUTTONS 3 

E=8.94 «Ratio used to maintain speed of craft. 
GTR IF B AND & THEN A=At+AL 

HEF IF B ANE 4d THEN A=A-AL 

ee IF B AND 15 THEN K=48.98 

EF IF A¢& THEH A=At+3648 

HER IF A?=368 THEN A=A-364 

TEP HL EHLERS VLE TLE +Decelerate. 

ERP S=CRLeR Lot Cy Ley 

HE MRE -8:NY=-8 

GE IF ¢B AND 16%==8 THEN #@hova 
GER IF S?5NAe THEN @hoVva 

HER T=RADCCA+1 889% 3683 

HEP RLS KL+COS¢ TI 28 

Tab YLSYL+SINC Ti 28 

TE MR=COSCRADC AS 3 #24128 

GER NY=SINCRADC A? 3 #24+96 

HE Z=2+1:5=5e7H8 

GEER IF 2716 THEN #=6:BEEP 1,5 «Play sound effect when craft accelerates. 
TE @hova 

mts: abe les tets Ly ote + Display fire when craft accelerates. 
HEF SPAHGLE @,A 

GER T=RADCCA+Z 259% BER 

Te MKECOS¢C To #R+128 

Te MY = STN OC To eR +96 

TF SPOFS 8, He, N47 

0073 Rt a ae a 

GM BGREADCL, 4-8, Y“89,C, PAL, H; ¥ 

CEP IF Ce=37S3 THEN GOSUB #@BOUNE +Process when craft collides with wall. 
TM BRE CK+CHL 2-128 9x512 
Te BY HCY + CHL 2-969 REL? 
TF BGOFS L, Be, BY 

TE VSYHO 1 

TE GOSUB @TCHE +Process that measures race time. 
Ee GOTO @hAIn 

[tree * ---------- 

EEF @ BOUND 

GE HRL=-K1i:71L=-vY1:BEEP 13 

HEE RETURH 

HE} SS SSeS SSS Ty All 

HE @TCHE 

GE T=FLOOR¢CK/6d9: J=FLOORCY bd 


* To Next Page * 


} Accelerate. 


t Obtain x and y coordinates for BGOFS. 


Special Section 100-Line Programming Corner 


IF I!=3 THEN RETURN +Inverts rate of acceleration. 

HEF IF J!=6 AND J!=8 THEN RETURH 

Ee IF J== ont ee 

DOEER F = J 

EER IF F!=8 THEH RETURN 

HER BEEF 7 

EEF T2=NATHCHTL <~System variable used to obtain frame rate. 


HE LOCATE 8, 2:PRINT "TINE:"; 

Joos l= pak UW IneStnl Lela ts 1 ee pal tetera 5 +Frame number is divided by 60 and 
TEER PRINT " SEC ":TL=T2 converted into number of seconds. 
EEF RE TURH 


4 Control your space craft and complete laps of the 4 When you reach the finish line. your time will be 
course. Once you get the hang of it, you'll even be able to displayed. You're competing with yourself, so aim to set an 
use drifting techniques. unbeatable personal best. 


Hey! Are you telling me there are no rival 
( G))) space crafts? Do you just fly round by 
yourself forever? 


Well, it is a 100-line program after all! Why not start by 
adjusting the layout of the track, and the parameters for 
acceleration and turning? 


Gan I'l teach you a good trick. You can fly the wrong 
‘) way round the track, and it will still record your lap 
> time. Seems the judges aren't too harsh here. 
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Meet the Woman of Your Dreams 


@ Introducing the Program 

This program is not to be taken too seriously. You play this game by turning your DSi or 3DS 
system on its side and talking to your beautiful virtual girlfriend. 
@ How it Works 

Rotate your DSi or 3DS system 90° so it looks like you have a photo of your beloved girlfriend. 
The rules are very simple. You select one of two different responses to your girlfriend by touching 
the screen, and the goal is to make her happy. You will face five questions. The more rapidly you 
respond, the more hearts you will rack up. 


> Give things an innovative twist by rotating the screen 
90°. 


Program List 


4433 -NI33 


om * ---------- LOVE TASU 
MP CLS:PNLTYPE "OFF" PRE 
TE @¢S TART 


GM GOSUB #6C:GCLS id 
MEP 8268: =36:BENSTOP 
GF RESTORE #GI1RL 
FOR K=1i TO il 

GP READ A#:GOSUB @TaTl 
GODER HE eT 

Tt @G TRL 

Ee DATA " 45am. " 1 
TEE DATA " Bee" 
DEEP CATA " 47“ " 
DEF DATA " 4% Hk" 
CATA " BI™=-n" 


Me cATA " Pl ii" L Girlfriend display data. 
Te DATA " + bee 
Me bATA " 4 " 
Te bATA " AB" 
TP DATA " TTT " 


GES DATA "LOVE TASU" 


TEER LVW=@: CHT=5:Mox#=8 Total question number assigned to the variable MAX. Variable CNT 


shows the number of questions asked. 


* To Next Page * 
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HEP GOSUB #@TOUCH 


TES @ MATH 

HEF GOSUB @60C:BGENPLAY 2:¥VSYHC 96 

TER RESTORE @HhESSAGE 

HER H=RHOCMNARS: TERN So 

TEFFOR I=68 TO H 

TE READ A, BS: HEXT 

Ee IF J THEN T#=A%:AF=BF:BF=TF < Shuffle the correct responses. 
TERR HS CBs =AF: NFCLI=HBE 

TEER FOR F=8 TO 1 

EDP H=LS6-CKh¥6ds YHS: CHR eS+2 

HERP GPAGE &8:GFILL #@, 7, 4#+48,192,0 

TER GPAGE 1:GFILL &#, 6, 4#+d8, 32,0 

TEP HH AtSH: YH T+s 

TEER AS=NECK2: GOSUB @THTEa 

CHEER HE & T 

TOP BGHPLAY 2d: H=192:He22d:7=68 

TOP GFILL &, 7, 4+16, (+H, 15 

TE @E WATT 

TEER WSYHC 2: BEEP &:H=H-d 

GOP GFILL &#, +H, A+16, 7+192, 8 

TER IF TCHST==8 THEN #@EWAITT 

TO AFH" O"  :TS=L-FLOOR¢CTCHAYL2ASS 

TT IF IT==J THEN #5SETKAI Evaluate response. 

TE AS="—" : BEEP 13:H=68 

TER @SEITEATI 

TEP R=166-CehOd*® la: Y=8:G0SUB @TRTL 
TEP FOR F=1 TO FLOOR¢H Yd 

GEER HE S2des Hod = LYELV +1 

TEER AS="" +5 TRFCLY2: GOSUB @TaATL 
TER EBEEP 67: ¥VSYHC 2 

GEER HE & T 

TEA YSvHC 68 

HEP CHT=CHT-1:1F CHT THEN #@HAIN 
HEF EGHPLAY 11:¥S7YHC 188 

HEF GOSUB @TOUCH 

HEF GOTO @5TART 


BAA 
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} Process for ending the game. 


WEF GPAGE 1:GOTO @TaT 
CHF e¢TaTa 

HE GPAGE & 

CE @ TT 

GF FOR IT=@6 TO LEN¢CA#3-1 


* To Next Page * 
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MEF C=ASCCONIDS¢ As, 1,133:P=68 

HEF CHRREAGE"BGFa", Cs, BFS 

OO Pe Vimo Ui aemably iylelP 2 

Oo PMs Way Yidl arabia Syisi 2 

THER VW VALS" BH" +HIDEC BFS, P, 133 
oa (Slrepok i= ASSES) Inieth! gabe 
RRM Tea Pee Pash. THs, Oo Subroutine that rotates character display 
GER HE es T by 90° 
GoE® HE es T 

Te Y= +16 

GORER HE es T 

GER A= —- 16: Y= 7Y-LENCAF 3 #16 

TE RETURM 

[or *? —------------------ 
EEF @ TOUCH 

GER GOSUB @60C:a=-16:7=6 

GER AS="TOUCH PANEL": GOSUB @TaTa@ 
HEE @ SWAT T 

GE IF TCHST==8 THEN #@5WATT 

TE 260 

GEER GPAGE @:GCLS:BEEP it 

GEER GPAGE 1:GFILL 4,8, 255, 36,14 
TE RETURM 

[OO Fe HESSAGE DATA 
HER @HESSAGE 

jong Se Ui) alee ShS) Sula 5 ay shhe = ilac (al al 
joosy esi) Pape) Saaeiole | Ya se) Siac ees” 
Ooss Ee ie) apap SOS) San ae (ela Yap S05) = ela) ig) tal 


RV a) Sella pe dg Uap al afer ae Question data. Repeats order for correct 
Byes) Yael? arial? eaihe  P seil aril al sea and incorrect responses. 


GEE DATA "FEN" RE", "FUFEN ZF" 
GER DATA "FSendsta","FSnraasta" 
EM DATA "S-baAIba", " +-bsauk? 4" 


C 74 But the graphics are so dated! I'm afraid she's 
just not my type. 
| do wish they'd made her a bit cuter. EP 


& \} Yes, I'm afraid | can't see a relationship budding with this 


ny young lady. There aren't many questions either. I'd say 


there's plenty of room for improvement in this program. 


Special Section 100-Line Programming Corner 


This Game's a Blast! 


@ Introducing the Program 
This is an old-fashioned game that utilizes parabolic calculations. You will set the angle and speed 
using the Touch Screen and then throw bombs at the target. 


@ How it Works 

This is a 2D game in which gravity plays a big part. You determine the angle and speed of your 
bomb using the Touch Screen, before throwing it and trying to take out enemies with the blast. The 
game ends when you use all 10 of the bombs you are equipped with. The bomb will not damage the 
enemies by just hitting them, so you need to get the timing of the blast just right. 


Program List 


* --------------- HS esis sels > 
ME CLS:PNLTYPE "OFF" 

TE @RETRY 

Ti SPFAGE &:SPCLR 

Mi SFSET @,142,4,6,9,4 

Mi SFANIN &,2,28:SPOFS 4,64, 99 
Ti SFSET 1,196,6,6,9,4 

Mi SPANIN 1,2, 28:SPOFS 1,164, 99 
TE GOSUB @TITLE 

To @START 

TH GOSUB @NAPINIT 

ME AX=9:AV=18d:TX=AX: TY=AY 


CHT=14:G05UB @HOUROU <The number of bombs you have it assigned 
=2HH:B=8 to variable CNT. 


TEER EX =RHDCLdea+8e -EY=RHDC 99 9+6d «Random values are used to assign 
Ti SPOFS 1, EX-8, EY-&:SPCHR 1,196 coordinates where enemies will be 
pre eet Ree acne a HAIN displayed. 

EEF @ MATH 

OOS ee Oe ed = 

HEP IF B==8 THEH #@FIRFE 

GE C=2:B=6B-1:1IF B THEH #BOUNDE 

HER GCIRCLE #&, 4%, 3@,C0:GPAINT #,; ¥;C «Graphic display of bomb blast. 
EER Y=2H8:BEEP 13 

HEP IF GSPOITCER, EV3==C THEN @CL 

TER VSYHC da@:GCLS 246:60T0 @haAtrn 

TE @BOUHD 


* To Next Page * 


BAA 
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HEP GOSUB @BGCHES 

GE IF C THEM H1i=-K1:BEEP & 

HEF GOSUB #@BGCHEY 

HE IF C THEM Yi=-Y1:BEEP & 

TEM IF YLtT THEN YLi=vite.1 Increase of gravitational acceleration. 
HERP H=AK+K1L YH +71 

EER TF ‘e288 THEN B= 

HEF GOTO @HAIn 

TEER @F IRE 

HE IF CHT==8 THEN #@60¥VR 

HE IF TCHST==8 THEN #HAIH 

EER CM T=CHT-1:TH=TCHA: TY=TCHY 
HEF GOSUB @HOUKOU 

TEP H=AR PS YHA: THATANCTY—-¥, TR-Ho ~ATAN function used to obtain angle of line. 
Ee CHRECOS¢Ta: CYS=SINCT3 

TE THRETR OK: TYSTY-7 

PEEP R=SGRCCTHE TH O+CTY# TY 99 428 

GT IF F?7 THEN F=7 

CEP HLHECK eR: YLECTRR + Obtains values for X and Y distance. 
GT B=198:BEEP 1i4:G0TO @HAIH 

Ct @ CL J SSS aS STAGE CLEAR 
GT SPCHR 1, 2652:BGHPLAY 49 

PEP VWSYHC Lee@:L¥=L¥4+1:G0TO @5TART 
HE @G0VR fF eSSaS GANE OVER 

TEP BGMPLAY 5&:A#="GANE OVER" 

HE GOSUB @THWAIT: GOTO @RETRY 

GEER @HOUK OU J SSSeo HOUKOU 

HEP GPAGE 1:GCL5 id 

HE GCIRCLE AX, AY, 1446,4 

HEF GLINE A&, AY, TH, TY, 2 

HE R=L68:7=T2:AF=STRECCHT A+" hae" 
HEF GOSUB @PUTSTR:GPAGE & 
EEF RE TURH 

TE @BGCHK Y SM BG CHECE +Collision detection for bomb and background. 
DE CREK  CYSY-T+YL:CKL=8:CYL=1d 
HEF GOTO @BGCHE 

EEF @BGCHE 

HEP CHEK -T+RL: CYS: CKLH1ld: CvY1=46 
EE @BGCHE 

HE C=8:FOR I=1 TO 2 

HEP BR=FLOORCCK 83 AHD 511 

HEF BY=FLOORCCY 83 AHD 511 

HEF BGREADCL, BR, BY, BC, PAL, H; ¥ 
Ge CRECK+CKL: CYSCYHC71 

Te C=C OR BC: HERXT: RETURH 
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Deflection when bomb hits an obstacle. 


Special Section 100-Line Programming Corner 


TE @MAPINIT EE a a oss INIT MAP 
GREP GPAGE &8:GCLS 2#46:BGNPLAY T 
GP H=RHDC289+18: Y=RNOCL14+14 
GE C=57: Wed: H=2:GOSUB @BGFILL 
GW Had: vy=22 

We C=92:W=28:H=2:GO0SUB @EBGFILL 
Tor RE TUR 


BAA 


OE @BGFILL Pees ale) (PW EL = 
Oe FOR TX=@ TO W-1 
HEe FOR TY=8 TO H-1 + Background fill. 


GEE BGPUT L,«+Ta, Y+T7, C, PAL, @, @ 
GEER NE wT: HEsT: RETURH 

GE @PUTSTR Sa Fastest os PUT STR 
MF FOR I=8 TO LENCA#4-1 

ME C=ASCCHMNIDS( AS, I, 133 

GE GPUTCHR «, ¥,"BGF@",C, 9, 2 
GEE X=e4+16:HEsT: RETURN 

EEF @TITLE Messssss'= Vw ble 
GEM GPAGE 8:GCLS:L=6:PAL=8:L¥=1 
GEM C=8:W=6d:H=6d:GOSUB @BGFILL 
GES BGOFS L, 8, 8: ASS" he ae ase 
DEER @ TWAT T ess (OWE ln) NEI 
GE GPAGE 1:GCLS 246 P 
GER HidS:Y=d8:GOSUB @PUTSTR 

GES Ha=S2: 751352: AS=" (TOUCH HERE?" 
TER GOSUB @PUTSTR 

HEE @TCH2 

GEER IF TCHST==8 THEN @TCH2 

GT BEEP T:BGNSTOP: RETURN 


quem no, soiydesy ou) Suneeg 


> Set the speed and angle using the lower screen, and let 
your bomb fly. If you can get your enemies caught in the 
bomb blast. you will proceed to the next stage. 


( HR It's not the most original idea in the world, 
but at least it's a proper game. I'll bet you could use that ATAN function for : ; 
calculating angles in lots of other games. OO) 


ray | think the problem here is that the program uses lots of 
\) colons, which can make it hard to read. But | suppose that 
a can't be helped when you've only got 100 lines. 


PAFRT4 Creating the Graphics You Want 


Give these a try and have even more fun with Petit Computer 


New Twists on Petit Computer 


@ Using a Magnifying Glass 


Programming using the Nintendo DSi for long periods of time can 
lead to tired eyes. This is why some bright spark suggested using a 
magnifying glass with a 12cm diameter with its own stand. This doubles 
the size of the screen display, but it does mean that you can't move your 
head while you program... 


@ Using Your Thumbs 


This is a method suggested by Hiroshi Yamasaki, who we met in 
the Single-Screen Programming Corner on page 68. Instead of using 
the stylus, he typed programs with his thumbs. The use of both hands 
increases efficiency, but the size of your thumbs means this method can 
only be used on the DSi XL or 3DS XL. It can also leave thumb prints on 
the screen... 


@ Using a Robot 


And here is the ultimate weapon that we've been dying to 
introduce. We created a robot with the ability to type using the 
building blocks in the LEGO Mindstorms NXT kit. The motor makes 
the robot move the stylus along the x, y and z axes and enter 
commands via the Petit Computer keyboard (data is sent via 
USB). In our trial, it took the robot about an hour to write a 160- 
line program with only 5 errors. 


Mi To see this programming robot in action in a Japanese video clip, 
check out this link: 
http://www. youtube.com/watch?v=KuZa-36 1 hPo 
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This section introduces the ultimate goal of this entire 
guide. The aim is to make use of the Petit Computer 
BASIC techniques you have learned and to create a 
large-scale program of your very own. We can't wait to 
see what you'll come up with. It's time to really put Petit 
Computer through its paces. 
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The maximum number of lines is actually 
9999, But | think these will be enough to be 
getting on with. It's hard work to enter all 
these lines, after all! 
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x Super Nova was the special move used by the eponymous hero of the hit 
Japanese manga series 'Game Center Arashi’. This move was so powerful 
that it actually put Arashi's life in danger. 


PARTS The Epic Program Challenge 


wien iae SD Effect Shooting Game 


Before polygon graphics became common in video games, BASIC used graphic scaling to produce 
a pseudo-3D effect in a lot of games. With Petit Computer, you can use sprites to make graphics with 
a more modern feel, but for a little blast of nostalgia from the past, we tried to come up with an old- 
style shooter. 


|# The Epic Program No.1 4 The Epic Program No.1 


Be Fast and Accurate and Hit those Space Ships 


@ Introducing the Program 

This is a pseudo-3D shooting game set in the depths of space. The graphics make use of GLINE 
commands to give the game a real retro feel. 
@ How it Works 

Your aim is to hit the red triangular alien craft with your missiles and wipe them out. Touching or 
sliding the stylus across the Touch Screen will move the target, with the A, B, X, Y Buttons and the 
+Control Pad all firing missiles. You have a limited supply of ammunition, so try not to waste it. When 
you have taken out a certain number of foes, you will progress to the next level. When enemies strike 
you, your shield will be depleted, and when it reaches zero, it's game over. 


Program List 


(i * ----------- SPACE MOLE 
TE CLEAR 

TE DIM B<za> 

Mi DIM Xi¢za>, Y1¢28> 

MH DIN GX<203,G7¢28> 

MF DIN GAC243,GZ2¢28> 

Mi DIM N<ig>,N¢189 

Mi DIM Mi¢ig>,Nicia> 


BHH=98:2NK=d8:21=1:HNH=5 «The radius of the explosions(variable BMX).The 
maximum distance to enemies(variable ZMX).The setting 

SSS SeSesosess RETRY for the number of stars (variables HMX). 

@START 

Te GOSUB @GTHIT Title screen. 


EF GOSUB @L¥INIT 


* To Next Page * 
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GE V=8:AS="S P A C E" 
TE GOSUB SHES 

GS Y=L2:As="N O L E" 
TP GOSUB SHES 

GEE BGHPLAY 1 

GEER GOSUB @THAIT 

GE @START 2 

Ee GOSUB @GTIHIT 

GER GOSUB @bATINIT 
GEER BGM STOP 

GE CLS 

CHEER ‘= 18 

GEFAS="R E AD Y" 
HEP GOSUB SHES 
CHEER = 15 

GEPAS="5 T AG E "+STR#¢l¥s 
TEM GOSUB SHES 

GEM J=i26:GOSUB @CHAIT 
GEER CLS 

GEER GOSUB @PUTEHE 

GE BGHPLAY 17 


Lo BS 


esuaeyD wessoig 9Idy SUL 


TER @ HATH +Main loop. 


GEER F = 4 

HER FOR IT=8 TO 14 

GOP IF B¢Cls<¢e THEN @ENDFOR 

ft F=F +1 

EP H=GRCL: Y=G7C13 

GEER IF B¢Cls==8 THEN @HOVE 

GOP BOTs =Bcla+3 

TTF GCIRCLE #, 7, BtI3,12 Operation during explosions. Draws circle using 
GT IF BCls<BNRK THEN @EHDFOR GCIRCLE command. 
Tie Bo Ta=-1 

TE GOTO #@EHDFOR 


HE @ HOVE | 
ee IF I¢ie THEN GOSUB @TEKINOVE — -Movement control. 
GEER IF IT?=148 THEN GOSUB @NvYNHOVE J 
GEER IF G2¢l33=2NeR THEN @0DANAGE 7 
TEP GOTO #@EHDFOR 

HEF @DANAGE 

HEF BO Ta=-1 Operation when your missiles or enemies reach 
CEP IF 139 THEN @EHDFOR | target. 

WEEP S= 5-25 
HEP GCLS 2 
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GOSUB @PUTEHE 
Sle lr? alal 

EF @ENDFOR 

COER MET 


EF GOSUB @TEKIFIRE 
TF GOSUB @FIRE 
ee IF S<=8 THEN 
MP IF CF+TEX== 
EF GOSUB SHOSHI 
Te YSYNC 1 

Te GOTO @haAlh 
0073 Bee iy 

OOP G2CTs=G2¢T3+21 

TEP GACT SSGRC TS +e1015 
OOP GYCTSHGYCLs+¥1ic13 
Tih RE TUR 

noe Ne 
CEP BMY MOVE 

Te GOSUB eh 

Ee H=GACTD 

re VY =GYCr> 

DEP Z=2NKX-G2C13 

Me L=2-72 

MF GBOX #X-L, ¥-L, &t+L, Y+L, 11 
or J=8 

oh @HITCHE 

MF IF BCJ> THEN @HSkKIP 

MEP BREGAC IO: BYHGYCIJ3:B2=G2¢)5 
TEP IF ABSC2-B25>8 THEN @HSKEIP 
TE DR=ABSCX-BH)> 
EEF IF DSL THEN 
TEER DY =ABSCY-BY > 
DEP IF DYs?L THEN @HSKIP 

DEEP BC J9=1:B°C13=1:P=6 

MET L=L2 

TEP IF DA<L AND BPY*L THEN P=1464 
HEF BEEP 13, P¥d& 

GEER SC=SC+P+18 

HF GOSUB @PUTENE 

Toe RE TUR 

GE @HSE IP 

CER J=J+1 

Ge IF J<ie THEN #@HITCHE 
TE RE TURH 


@GANEOVER 
THEN @NE&aTLY 


@HSKIP 


«Enemy attacks. 
+Player attacks. 


«Display bullets with GBOX command. 


«Collision detection for missiles. 


+ Sets explosion flag when missile hits target (array 
variable B). 
«High score when hitting a narrower target. 
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Mi @TEKINOVE 
ME GACT 2=(GACId+19%368 

MEE IF RNDCS><L¥ THEN GOSUE @n¥ 
ME X=GREID 

me Y=GYC1> 

ME Z=GZ¢1> 

MEP A=GACI> 

ME TXI=COSCRADCCA+ G>xN36H> 2 #Z+K 
ME TYL=SINCRADCCA+ G>xNSEH> 2 #Z+Y 
ME TRE=COSCRADC CA+1 20943609 2#Z+K 
GE TY Z=SINCRADC CA+1 20943609 #Z+Y 
ME TXS=COSCRADC CA+2dH 943609 2H Z+K 
MEE TYS=SINCRADC CA+2dH 94360) 2H Z+Y 
GE GLINE Ti, TYi,TH2,TY2,2 

GE GLINE TX3,7Y3, TH2,TY2, 2 

GE GLINE Ti, TY1,TH3,TY3,2 

MEP GCIRCLE X,¥,Z/d ,2 

GE RETURN 

EER * --------------- GAME OVER 

HEP @GANEOVER 

EP EGNPLAY 15 

DED Y= 6 


GERAS="G AM E 


ee ee a 


GOSUB 
HER GOSUEB 


GEER J=156: 


GOSUB 


@NEsS 

aT Ee 
GOSUB @CHAIT 
STHWAIT 


5-1 3D Effect Shooting Game 


L Enemy movement and display 


esuaeyD wessoig 9Idy SUL 


EE GOTO @5TART 
DER oo ee 
HES @HEATLY 

HEM BEMNSTOP 
HEED = 148 

GE AF="5 T AGE 
EM GOSUB @NEs 

Hie BEEP 7 

He VYS'YNHC 16 

HEE J=1268:G0SUB @CH 
HE LVWELYV+1 

He GOTO @START2 
DU a ee 
Hi @CUuRSOR 

HEP ARS TCHR: AY=TCHY 
HT SPOFS 8, AK, AY 
EE BTNH=BUTTONS 3 
ee RETURN 


ee 1S i ie 


AIT 


-PUT CURSOR 


4 Target matches stylus movement. A, B, X, Y 
Buttons and +Control Pad launch missiles. 
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WEEP * -------------- MOVE HOSHI 
HEE @HOSHI 

Eb FOR I=@ TO HMX-1 

WE M=MCID4+M1¢19: Y=NCT34+N1CT9 
ME IF ¥<i OR X>25d THEN @HOSHI4 
WEP IF Y¥<i OR ¥>191 THEN @HOSHI4 
HE GPSET x, 7,15 

DEP NCI2=X:NCIDSY 

Hb GOTO @HOSHI2 

a @HOSHI1 

ME MC 13=128:NCT3=96 

MEP R= (RNDC1G9759+68.5 

Tb T=RADCRND¢ 36893 

GE Ni C12 =COS<T¥R 

ME NLC T2=SIN¢ TO ¥R 

Hab @HOSHI2 

Eb NEXT 

TE RETURN 

(up * --------------- WAIT CURSOR 
Te @CWAIT 

TE GCLS 

TE GOSUB @HOSHI 

Ti GOSUB @CURSOR 

Te VSYNC 1 

We J=J-1:1F J THEN @CWAIT 

Ti RETURN 

(uER * --------------- MY MISSILE 
TEE @F IRE 

TE GOSUB @CURSOR 

Toe FCNT=FCNT+1 

ME IF FCNT<1i6 THEN RETURN 
GREP FCNT=16 

GE IF BTN==G THEN RETURN 

GE FCNT=4 

ME IF E<=@ THEN BEEF 9:RETURN 
To 1=16 

GE @FIREL 

MEE IF B¢I><G@ THEN @FIRE2 

HED I=1+1 

HES IF 1219 THEN RETURN 

GE GOTO @FIREL 

GEE @FIRE2 

HED E=E-1 

GE BEEP 18 

GE BX=Ax 

DE BY=AY 


+ Movement of stars in background. 


+ Button input, missile launch. 
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EEF GOSUB @PUTENE 

GEER @SETHAY 

TP GACTS=Ba 

Ee GY CTA=BY 

PEP RIC TSS CAR -Ba oe tena el 
PEER VICI SC AY-BYo Cena 21 
BCT =8 

PE G2¢T3=6 

fe RE TURM 

PE Si SiS si WE Ls Un) WSS) UL 
TT @TEKIFIRE 

TER IF TE<=8 THEN RETURN 
TP IF RNOCSB> THEN RETURN 
Tee I=6 

TEE @ NEW BL 

PEER IF BCl><@ THEN @NEWB2 
TP T=1+1 

EP IF T?9 THEN RETURN 

CE GOTO @nhEWeL 

Oe ee SELECT TARGET 
TEP @NEWB2 

TRERB AX=RNDC256-6d49+32 

TEP AY =RNDCL9I2-deat+ed 

Tae TE=TE-1 

PEEP BH = RND C2563 

TEER BY =RHDCLI2 3 

EER GOTO @SETay 

TEER a aaa INIT SCREEHW 
TEE @G TNIT 

TEE CLS 

TEER SPPAGE & 

DEER SPCLE 

TEMP SPSET &, 255, 2, @, @, 2 
TE PHLTYPE "OFF" 

TEER GPAGE & 

GEEER GCL S 

TEER RE TUR 

GREER is eal INIT SCORE 
PEEP @LYINIT 

EEF SC =H 

0238 ee 

GEER @DATINIT 

TET F = 8 

Tee TE=12 

TH FOR I=6 TO 134% 
PER BCT 3=-1 


5-1 3D Effect Shooting Game 


SCORE 2146 


~eh 


MISSILE 16 SHIELD 166 


4 Blow the red triangular alien craft out of the 
skies with your missiles. Each time you clear a 
stage, your enemies’ speed will increase. 


SCORE 846 


MISSILE 13 


AHitting an enemy will result in a huge explosion. 
If you hit an enemy right in the center, you will 
get maximum points. 
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CEP ME wT 
Tae E= 28 
Ta? S=188 
Ta RE TURH 


PEER @PUTENE 

PEF LOCATE 2, 22 

Ee PRINT "HISSILE ";E;" " 
TE LOCATE 195, 22 

PEEP PRINT "SHIELD ";5;" " 
PEEP LOCATE 12,1 

PEEP PRINT "SCORE ";5C 

TEE RE TUR 


TET @TWAIT 

TEER IF TCHST THEN #@TWAIT 

CEP GPAGE 1 

Te GCLS id 

TF PHLSTR 3,16, "TOUCH SCREEN", 2 
PEEP @ TOUCH? 

EAP YSYNC 1 

EP IF TCHST==8 THEN #@TOUCH2 
TF GOLS id 

TEP GPAGE & 

TET RE TURM 

TEER oS SS PRINT MESSAGE 
TET @ MES 

Te LOCATE 1L6-CLENC AS34235, 7 
TER PRINT AF; 

TEER RE TURH 


SHIELD @ 


4 Get hit by too much enemy firepower and your 
shield will hit zero and it will be game over. 


fe So using flat shapes in this way is a 
way of creating a pseudo-3D effect. 


But those alien craft 
look pretty flimsy to 


me! 


This program makes use < dicen eatin at sant os the Touch 
Screen, meaning that it's making the most of 


Petit < dicen eatin at sant os unique features. 


F-H2 Maze Action Game 


Maze Action Game 


In the 1970s, at the dawn of the video game era, there were many games which, while they did 
not come close to today's games in terms of graphics, boasted great ideas which made them classics 
we remember fondly to this day. We have used the more advanced graphical capabilities of Petit 
Computer to come up with our version of a classic maze game. 


|# The Epic Program No.2 4 The Epic Program No.2 


A Maze Game that Respects the Traditions of Times Past 


@ Introducing the Program 

This game reboots the early Japanese classic, Heiankyo Alien. 
@ How it Works 

You control the player character with the +Control Pad, dig holes in the ground by pressing the A 
Button, and fill them in again with the B Button. You clear each stage by trapping and burying all the 
aliens. 

Once an alien falls into a hole, there is a limited amount of time before they climb out. If a hole is 
not big enough, it will be refilled if an alien passes over it. 


Program List 


DO HEISEI ALIEN 
Core CLEAR 

GER DIN @¢15, 123 

GMP OCINH Tatlies, TY¥yel@s 

GF CIN TOtlies, THeLes 

GMP CIN wicdo, YLleds 

GP sites = L:Yites= &@ 

GP wLcls= B:Y¥icLlsa= 1 

GER LC 29S-1L:Y1Lt25= @ 

GP LCS Bs YLCsa=-1 


Toe GF =5 Snes aed to variable QF when there is a 
| Nd. 

Ep * ------------ RETRY : 

TEER G@RETRY 
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GE GOSUB @SCRINIT 

MF CY=3:AF="H E I 8 E I" 
TH GOSUB S@PUTA 

i CY=11:As="A L I E WN" 
TH GOSUB S@PUTA 

EP LV=1 

EF EGHPLAY 16 . 
Ee GOSUB @HITANY Explain 
M022 ) tS SSeS START "Heian Ailien" 
EF @ START 

DEF GOSUB @SCRINIT 
EF GOSUB @hAPINIT 
GE GOSUB @nyYInItT 


Title screen display. 


This is Maze Action Game developed 
by members of Tokyo University. This 
was developed for PC(Apple2) Game in 


Tb GOSUE @TEKLIWIT 1979, it was ported into arcade game 
cLs by the manufacturer in next year. Its 
EEF BGMSTOP peculiarity is how we fight against 
HE CY =8 Aliens.|t is by digging and burying 
TE AS="5 T AG E "+STR#CL¥3 them. 

GER GOSUB @PUTA There are a lot of games ported 


DEER CY=12:AS="R E A D Y¥" 


TER GOSUB @PUTA fees : 
TE VSYNC 188 We get the permission of this 


TE CLS game from the member of this game 
TEP BGMPLAY 26 developer team "Arimasa Takeshige". 


TEER CY = 22 

TEER AF="HOVE @GUNERU G@HORU" 
TF GOSUB @PUTA 
Te GOSUB @PUTSC 
TE OW R= 8 

QQ) PSS SS SS SSS ae HAIN LOOP «Starts main loop. 

TI @hAIH 

Te YSYHC 1 

TF GOSUB @NYCTR 

TF GOSUB @TEKINOVE 

HEF IF TCT==8 THEN @HEXRTLY¥ 

EER IF OVR==1 THEN #GANEOVER 

HEF GOTO @hHAlH 

D051) SSS SSS SS SSS LOU) estan, [iil te 

TE @ NY CTR 

EER IF M THEN #@nH¥2 

HEF BTH=BUTTONS 3 

EER CHT=*CCHT+1°3%148 

HE IF CHT THEN BTH=BTH AND &HEF <9 times out of every 10 loops, the A/B Buttons will be disabled. 
TE IF BTH==8 THEN RETURN 

HEF IF BTH AND 1 THEH D=3 

EER IF BTH AND 2 THEH D=i 

HF IF BTH ANE 4 THEN D=2 


* To Next Page * 


across their machines. 
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HEe IF BTH AHD 8&8 THEN D=& 

TF IF BTH AHD &HE8 THEM #@HORU 

HEF IF BTH AHO &HASB THEN @UNE 

TER SPCHRE 8, (b¥d9+6d +The player character display will switch depending on the 
direction it is moving. 

TF GOSUB @BGCHENY 

i IF C THEH RETURN 

TF BHABHA? 

TH BY=BY #2 

IP (eis (sacs (ete a! Wallet) Lele 1 WW] saline nee ts eM in front of the PC, it will be unable to 

H=16 «Sets the number of pixels the PC moves with each step. 

a HOVE HY 

The @ hi 2 

PER H=H-21 

TH HER tHKL Ds YH t TLDs PC movement. 

ThE SPOFS 8,4, 7 

Thi RE TUR 

DON Y oS SSeS HORU 

Tick @HORL 

ER J=1 

TH GOTO @UunE2 

DT UMNERU 

TEE @UAE 

DEER J=-1 

Ti @UHE2 

Ti GOSUB @BGCHENY 

i IF C THEH RETURN 

Tie BHEBAR AZ 

Ti BY=BY “2 


TEER T=HCBR, BYo + J Digging and filling holes. The array Q will store the 
HE IF ITF THEH RETURN current state of each hole. 

Ee IF I<6 THEN FETURH 

TERR BEEP 49 


TEE CBX, BY=1 
ME GFILL CX, CY, CX+15, CY+15, 1 
ME IF I==8 THEN @UNETEKI 

ME CX=CK+E: CY=CV+8 

ME GCIRCLE CX,CY,1+2,13 

TE GFAINT Cx,CY,1d 

ME IF I==GF THEN BEEP 8 

To RETURN 

(oR * ----------- TEKI UMNERU 
GO @UMETEKI 

ME FOR I=a TO 4 


score a! 1! 


<f 


GE IF Cae!=TACIS THEN @ENDFOR2 SMOVE. GQUNERU eee 
PO IF CY!=TYCIs THEN @ENDFOR2 
T¥elye-i 4 The player character can dig holes and then 


SC=SC+16 refill them. 
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PEF BEEP 13 

PEER GEM DFOR? 

ET HE & T 

Te GOSUB @PUTSC 

TE RE TUR 

11d) OSS SS SSS SSeS WAR Uae etal 
Te GM Y INIT 

HEF PAL=2 

PEP H=8:bD=1:C=68:N=6 

Ta = T#1LE: Y=5"16 

EF SPSET H,C, PAL, &, &, 2 
TEER SPOFS H,#, 7 

HEF SPANIN WH,d,148 
ee RE TURH 

N22) SSS SSS SaaS IE Webs dl 
TEER @ TERK INOVE «Enemy movement. 
HE TC T=8 

TEER FOR I=8 TO THHR-1 
EE H= I+ 

ERP CHETH OLS CYHTY CIS 

EER IF CyY<@ THEN #TEKICLR 
EER TC T=TCT+1 

EDR IF TOCT333 THEN @ANA2 
ERP IF TNCI>® THEM @TEKI2 
TEER JT=TODCI3 

TEER T= J+RHO¢ 39-1 

EIR IF J3=d THEN J=J-d 

TERR IF Jia THEH J=J+4 

TER CHECK +0 R10 T3165 

EMP CV HECY+ C710 T3"165 

EEF GOSUB @BGCHE 

TEER IF C THEN @EHDFOR 

HT TOC T=] 

THe T3=16 Sets the number of pixels enemies move with each step. 
POR C=C LVR POLE +129+0 J¥ 23 
PER SPCHR HAC 

EF GOTO #@ENDFOR 

EF @TEKI2 

TT T= TDCI 

PE CHECK +KLC Ta -CYSCY +1073 
HE SPOFS H,Ck,CY 

PEER THC IS=SCK: TY CISSCY 

ET THC TS=TNE Ta-1 

EP IF THE Ls#16 THEN @HITCHE 
ERP BRECK “16: BY=CY-16 

TEER IF CBR, BY> THEN @ANHAIN 
ELF @HITCHE 


Enemy direction of movement switched using random 
values. 
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ME IF ABS¢CK-X)>8 THEN @ENDFOR 
MEP IF ABS¢CY-¥9>8 THEN @ENDFOR 
Tb OVR=1 

Eb GOTO @ENDFOR 

(EER * ----------- ANA OCHIRU 

To @ANArn 

Hae THC 13-8 

MP IF G¢Bx, BY <G@F THEN @ANAOQUT 
MEP SPOFS N,CX+d, CY+d 

Tb SPSCALE N, 5a 

Mi TDC 12=NTM 

TE BEEP 6 

Eb GOTO @ENDFOR 

[b * ------------ ANA DERU 

TE @ANAa2 

Mb BX=CX “16: BY=CY 716 

MER IF G¢Bx, BY3==G THEN @ANAOUT 
WE TOC L3=TDE I-41 

GEER IF TD<I>>3 THEN @ENDFOR 
Tb @ANAOUT 

ME TOC 13 =RNDEd> 

Ta SFSCALE N,.1i8a 

Ta BEEP i 

TE OC BX, BY>=@ 

Tb BX=BX*16:- BY=BY*16 

ME GFILL BX, BY, BX+15, BY+15, 1 
He GOTO @ENDFOR 

[EER * ------------ CLEAR TEKI 
GE @TEKICLR 

ME SFOFS N,-16,-16 

TE @ENDFOR 

NEXT 

To RETURN 

[OEP * ------------ INIT TEKI 

HEE @TEKIINIT 

HE THX=LV+2 

He IF THX>1G THEN TNX=18 

TE PAL=3 

HEF FOR I=a TO 4 

HE C¥=-16 

GE IF I>=TMX THEN @INI3 

HE @INI2 

GE CX=RNDCS 3 #de4+16 

GE CY=RNDC do ¥de4+16 

MEE IF ABS¢CK-X9<32 THEN @INI2 
[TP IF ABS¢CY-¥9<32 THEN @INI2 
[EP @INI3 


F-H2 Maze Action Game 


«When the PC and enemies come into contact, the variable 
OVR which stands for the Game Over flag is set for 1. 


«When the array TD is greater than 3, an enemy is in a hole. 


SCORE 16 


SNOVE GQUNERU OHORU 


A Fill in holes where enemies are trapped to 
defeat them. 


«Sets maximum number of enemies. 
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OAL 


PARTS The Epic Program Challenge 


PEEP THOT SSCK TY CTs Scy 
PEER TDC TS =RADCd 3 

PET THe 1s =8 

TEER = I+ 

PE C= CLV APO eLE +125 

Tee SPSET WC, PAL, &, &, 2 
TTF SPOFS WH,Ck, CY 

TEER SPANIN WH, 2, 14 
PET HE & T 

LEP HTM=268-CLY #1 eo 

PEEP IF HTHtide THEM HTM=1 
TEER RE TUR 

[Ege * ------------ AUNT ae =e Fes a 
TEP @SCRINIT 

fe CLS 

Tear SPPAGE & 

fete SPCLE 

TEER GPAGE & 

EET GCLS 

TEP BEGPAGE & 

TEER @BGCLE 

TEEER PAL = 

TEER FOR LAY=8 TO 1 

TPEEER W=S2:H=2d: C8: 4-8: 7=8 
TEE GOSUB @BGPS 

TEP BGOFS LAY, &, 
DEEER HE i T 

TEEER RE TUR 

[EEN 7 —----------- INIT HAP «Resets maze. 
DEEP @MAPIWIT 

DEEER CLS 

PEEP GFILL 8, 4, 36#8, 2d#5,1 
TET FOR Y=8 TO iL 

TEER FOR #=8 TO id 

DEEP Cw, Ta=8 

DEEMP HE T 

DEEER HE i T 

DEEER PAL=4 

PET LAY =8 

[EES W=2:H=2:C=38 

TEP FOR H=8 TO 28 STEP 2 
TEER (=H: GOSUB @BGPs 

PET = 22: G05SUB Bors 
DEDER HE & T 

TET FOR Y=8 TO 22 STEP 2 
TE w=: GOSUB @BGPs 

PETE w= 28: GOSUB @BGPs 
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F-H2 Maze Action Game 


DETER HE # T 

TRF FOR BY=48 TO 16 STEP 2 
TEP IF CBYXE3==H THEN @NAP2 
TEERP FOR Be=e TO 22 STEP 2 
PEER IF (Bex 69==8 THEN @NAPS 
TEETB HES BR+S: YHEBY+2 

TEER GOSUB @BGPS 

TEE PHM AP2 

DEE HE # T 

TEE @ MAPS 

DEEER HE # T 

Te FOR BY=8 TO id STEP 6 
TGS FOR Bae=S TO 2H STEP 12 
PE H=B RS YHBY 

TEER D=RHD Cd 

TEP FOR MN=H TO L 

265 eae ee ee i eo a | Blocks a number of the maze's paths. 
TE GOSUB @BGPSs 
DEG HE & T 
PEE HE & T 
DEER HE # T 
fF RE TUR 


Lo BS 


esuaeyD wessoig 9Idy SUL 


[EP FOR I=@ TO H-i 
[De FOR J=a@ To W-i 

TEE CC=C+C1# S294) 

TE IF C<ié THEN CC=C 

[EF BGPUT LAY, X+J, ¥+1, CC, PAL, @,@ 
TE NEXT 

TEP NEXT 

TE RETURN 

Te * ------------ CHECK MY 

TEE @BGCHKMY 

PEP CR=H+K1 0D 916 

TD CY =Y+¥1 0D 3 #16 

TEER * ------------ CHECK BG 

TE @BG CHK 

Te BX=FLOORCCHY/S x64 

TEE BY =FLOORCCY/8>%6d 

[EEF BGREADCLAY, BH, BY, C, PAL, H, ¥ 
TE RETURN 

TE * ------------ PRINT SCORE 
TER @PUTSC 

TEER C= 1 

EE A¢= "SCORE "+STR#¢SC) 

TEER * ------------ PRINT TEXT 
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PARTS The Epic Program Challenge 


TEE @ PUTA 
TEP LOCATE 1i6-LEN¢aAsi 72,04 
TEER PRINT A#; 

TEER RETURH 

fem * ------------ NEXT LEVEL 
Ee @NEXTLY 

ETP EGMPLAY 49 

TEDER CY = 

EM aAt="5 TAG ECL EA R" 
ED GOSUB @PUTA 

TE LHL ti 

EGP YSYNC 5*é6a 

ET GOTO @START 

[EER * - ----------- GAME OVER 
EEF @GANEOQYVER - SCORE 29 
ERP EGHPLAY 4 : 
TEP CY = 8 

EP AS="G AM EO ¥ E R" GAME PW ER 
EM GOSUB @PUTA : 
TERE SPCHR a, 38 
ES YSYNC 126 
EP GOSUB @HITANY 
TE GOTO @RETRY 


a HIT ANY KEY SNOVE QUNERU @OHORL 

EE @HITANY 4 |f you bump into an alien, it's game over. Be 
IF BUTTOH*> THEN @HITAHY sure to plan where to dig holes carefully. 

TEER CY =1T 


EER AS="CHIT ANY BUTTONS" 

ERP GOSUB @PUTA 

EEE @HITANY2 

ER YSYNC 1 

ERP IF BUTTON®3==68 THEN @HITANY2 
ERP RETURM 


This is really old-fashioned. Maybe 
it's because it uses sprites, but it 
doesn't have the feel of the original. 


If you remade it using character strings 
to create the graphics, it might feel more 
faithful to the original. 


&> } With the capabilities of the Petit Computer, it wouldn't be a 
CVC) problem to make the background scroll. It would be good to build 
on this and come up with a totally different game. 


Appendix 


Petit Computer Resources 


There is a detailed set of instructions included in the Petit Computer software 
which can be viewed by pressing the Help button on the lower screen keyboard. The 
same information is also available on the Petit Computer website. 

It can be a little fiddly switching between Edit Mode and the manual when you are 
working on a program. Some users may prefer the ease of studying the instructions 


online while programming on their Nintendo DSi or 3DS. 


* Color palette, character code, system icon, BG/sprite character, they are in page 10-16. 
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Appendix 3 = COMmmMands LiSt vrrrrrrrrrrrerreeeeeeeeeteeeeeeeteeeeeteeeeeeeeeeeeeeeeeeeeeeeeeeeeeeneeeees 1z2y 


1 Run Mode-Specific Commands NEW, LIST, RUN, CONT, FILES 


LEAR, =, DIM, REM, @. KEY, VSYNC, ON~GOTO,. 
N~GOSUB, GOTO, GOSUB, RETURN, STOP, END, 
OR~TO~STEP, NEXT, IF~THEN, IF~GOTO,. READ, 
ATA, RESTORE, TMREAD(), DTREAD() 


LS, COLOR, LOCATE, PRINT, CHKCHR(), 
UTTON(), INKEYS$(), INPUT, LINPUT 


OAD, SAVE, DELETE, EXEC. RENAME, RECVFILE. 
ENDFILE 


42 Basic Commands 


NOOO 


43 Basic Console Commands 


WOO 


fd File & Communication Commands 


QO I 


45 Drawing Commands VISIBLE, COLINIT, COLSET, COLREAD(). CHRINIT. 
CHRSET, CHRREAD() 

46& Sprite Commands SPPAGE. SPSET, SPCLR, SPOFS, SPANIM, 
SPANGLE, SPSCALE, SPCHK() 

&7T BG Screen Commands BGPAGE, BGCLIP. BGOFS, BGPUT, BGREAD() 

48 Graphic Commands GPAGE, GCOLOR. GCLS, GSPOIT(), GPSET, GPAINT. 
GLINE, GBOX, GFILL., GCIRCLE, GRPUTCHR 

43 Audio Commands BEEP, BGMPLAY,. BGMSTOP, BGMCHK() 

14 Panel & Icon Commands PNLTYPE, PNLSTR, ICONSET, ICONCLR, ICONCHK() 

11 Text commands ASC(), CHRS(), VAL(). STR&(), HEX$(), MIDS(). LENO 


12 Basic Mathematical Functions FLOOR(), RND(), ABS(), SGN(), SQR(), EXP(), LOG(), 
Pl(), RAD(). DEG(), SIN(), COS(, TAN(). ATAN() 
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aaa System Variables 


Numeric System Variables 


Read Write 
CSRX 


O 


Current cursor x-axis (horizontal) position 


Current cursor y-axis (vertical) position 


Remaining memory available to user(Kbyte) 
System Version (OxAABBCCDD, Version AA.BB.CC.DD) 
Error number immediately after error occurred 


Number of line where error occurred. 


x coordinate pressed on Touch Screen. 


y coordinate pressed on Touch Screen. 
Touch status(TRUE = Touched) 


Time Touch Screen is touched for(Given in number of frames) 


TCHTIME 
AINCNTL 
AINCNTH 

TABSTEP 

TRUE 

FALSE 

CANCEL 

CONPUSE 

CONPAGE 


Frames elapsed since start of program (max. 145 minutes) 


Duration of frame display since program launched (data over 145 minutes) 
Amount TAB key will move(O-16) 
Always 1 


Always O 


Always -1 

"FALSE=Don't use 

TRUE=Use" 

Page number for user system icon(O is always entered in Run Mode) 


aximum number of pages for user system icon(Does not work in Run 
ode.) 


Number of function key pressed (1-5, O=not pressed) 


Om © el <x Bae x fel x Bal <x Bal <x Bal <x Be <x Ba x «Be 


CONPMAX 


FUNCNO 
FREEVAR 
SYSBEEP 


Number of variables that can be saved 
System sound effect controls (True = ON, False = OFF) 


OJOJO}] O JOJOJOJOJ;OCJSOJO;OJOJOJ;OJ;O!C/}/OJO|O};O;O 


Text String System Variables 


Read Write 

Obtains current time as a string (HH:MM:SS) 

Obtains current date as a string (YYYY/MM/DD) 

Number of strings that can be saved in file(MAX 255characters) 


Appendix 


Error Number Chart 


Appendix 1—_ System Variables Appendix. Error Number Chart 


When you get Error, Error Number is in System Variable ERR, and Line Number is in ERL. 


Syntax error 


There is problematic grammar in the program. 


Out of range 


The value exceeds the valid range. 


Out of memory 


There is insufficient memory available. 


Undefined label 


The destination for a branch instruction cannot be located. 


EXT without FOR 


There is a NEXT command which does not belong to any FOR command. 


Out of DATA 


There is insufficient DATA available for a READ command. 


llegal function call 


There is a problem with the assignment of elements in a function or 
command. 


Duplicate definition 


The same array or variable has been defined more than once. 


@)] 0 | SI) © | On) B | Go) = 


Can't continue 


A program cannot be continued using a CONT command. 


issing operand 


There are insufficient parameters. 


= 


Duplicate label 


The same label has been defined more than once. 


llegal resource type 


The resource type designated by a string does not exist. 


= 


llegal character type 


The designated character type does not exist. 


String too long 


The string is too long. Labels should be no longer than 8 characters, while 
strings should be no more than 256 characters in length. 


= 


Division by zero 


A number has been divided by zero. 


. 


Overflow 


The results of an operation have exceeded the permitted range. 


— 


Subscript out of range 


The subscript for an array variable is out of range. 


Type mismatch 


Variable types do not match. 


= 


10 
1 
12 
3 
14 
5 
6 
U 
18 
i] 


Fomula too complex 


The formula may have too many bracketed sections, or otherwise be too 


complex. 


RETURN without GOSUB 


A RETUR 
command. 


command is present without an accompanying GOSUB 


FOR without NEXT 


A FOR command is present which does not correspond to a NEXT 
command. 


Ba xipueddy § H xipueddy 
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Appendix 7 
Commands List 


f 1 Run Mode-Specific Commands NEW, LIST, RUN, CONT, FILES 


There are 5 commands that can only be used in Run Mode. These are related to running and 
continuing programs and cannot be written into the programs themselves: 
HE lH 
This deletes the program. 


Format NEW 
Parameters | None 


LIST 


Switches to Edit Mode and begins edit. 


LIST 
LIST @label 


LIST line number 


Line number Designate line where source is displayed(Can Be Omitted). 
@label Designate line where source is displayed(Can Be Omitted). 


Parameters 


Error When line number or label does not exist. 


RUT 
This runs the program. 


Format RUN 
Parameters | None 


CONT 


Continues a program stopped with a STOP command. 


Format CONT 
Parameters | None 


Error When program has been run and cannot be continued. 


FILES 


Displays a list of files on the console screen. 


Format FILES [file tyoe name [, file tyoe name...] ] 


Parameters | File Tyoe Name Designate if you want display only specified resource. 


Appendix 3 Commands List 


fH? Basic CLEAR, =, DIM, REM, @, KEY, VSYNC, ON~GOTO, 
Commands ON~GOSUB, GOTO, GOSUB, RETURN, STOP, END, 
FOR~TO~STEP, NEXT. IF~THEN, IF~GOTO, READ, 

DATA, RESTORE, TMREAD(), DTREAD() 


Initialize memory,Conditional Branch ,Loop,Conditional Judgment,Read and Write data,etc: - - 


CLEAR 


This resets variable names and BASIC internal memory. 


> 
aS) 
U 
oO 
= 
2 
x 
= 
a 


Format CLEAR 
Parameters | None 


=CLET3 

Assign (an abbreviation of the LET command) 
ABC=123 

TEXT$="ABCDE" 

Parameters | None 


Format 


DI 

Array declarations.element count for up to 2 dimensions. Element count can be defined up to a total 
of 32768. 

DIM pos( 4 ),size( 4 ) 

DIM sample( 10. 5 ) 

Parameters | None 


Format 


*CREMN2 
For annotations(comments). The text following this command up to the next linebreak will be ignored. 


REM The following is a comment 
"comment text 


Format 


Parameters | None 
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a 


LABEL definition. This always needs to be added at the start of a row. It can be used to give 
destinations with commands such as GOTO and GOSUB. 8 character string(except space) following 
@ will become the name under which it is saved. When you use this insted of line number, you must 
write '@' the top of the line. 


@NAME1 
Format @SAMPLE The end is after 8 characters or space, after that the text up to the next 
linebreak will be ignored. 


Parameters | Label name Unlike strings, it is not necessary to enclose with ™ 


When characters or symbols that are not alphanumeric 
Error characters or '_' are in a label name. When the label name is not 
defined. 


SAMPLE : Back to the label line. 


Ch A= 8 
Cote @ 1 

CHEER A=A+1 
THe PRINT A 
te GOTO @1 


KE‘ 


Assigning Strings to Function Keys. When used in a user-created program, the string data assigned to 
the function key will be entered in the program when that key is pressed. 


Format KEY number, "string" 

Parameters | Number Function key number(1-5) 

Only 4 characters from the assigned string will be displayed, but 
String strings of up to 256 characters can be saved. When the full string 
cannot be displayed, the last character will be displayed as '\' 


When a number is designated that does not exist. 


VSYHC 


Same length as screen renewal time (waiting for graphics to be renewed). 
To use in loop, you can use wait and keep its process regularly.(1/60sec per 1 frame) 


Format VSYNC Frame number 


Indicates number of frames since the VSYNC command 
immediately beforehand. (O = ignore) 


Parameters | Frame number 


The example of use (P57 EXAMPLE 3-05,EXAMPLE 3-08.etc) 
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OH ~ goTa 
Causes program to branch depending on numeric values. 


Line number when ON variable GOTO variable =O (or @label), numeric value 
Format 


1, numeric value 2... 


Parameters | None 


SAMPLE : Processing with numerical values of the variable A. 


Te On A GOTO @H, @1, @2 

CLTE SIOI040000 Operation with variable A NOT 0,1.2 
COLER @ 
TF Sooo oSO000 +-Operation with variable A = 0 
CLEP @ 1 
SOOI090000 Operation with variable A = 1 
a? 
SI000R00000 Operation with variable A= 2 


> 
AS) 
U 
oO 
= 
3 
x 
= 
a) 


The example of use (P47 SAMPLE2) 


OH ~ GoOsSuUB 
Calls a sub-routine based on number 


Line number (or @label) when ON variable GOSUB variable =O, numeric value 
Format 


1, numeric value 2... 


Parameters | None 
The example of use (P77 Avoid Using GOTO Wherever Possible @) 


GOTO 
Forced branch. 


Format GOTO @label 
Parameters | None 


The example of use (P47 SAMPLE2,P55 EXAMPLE 3-03,etc) 


GOSUB 
Call sub-routine 
Format GOSUB @label 


Parameters | None 


The example of use (P65 Single-Screen Programming @,P76 A Smart Approach to Programming,etc) 
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RETURH 


Returns from a sub-routine. 
Always use this command in conjunction with GOSUB. 


Format RETURN 


Parameters | None 
Error If GOSUB is not done, display error message “RETURN without GOSUB". 


SAMPLE PROGRAM 


Co A= 8 

TE GOSUB @SUB 
CODER A= 1 

GH GOSUB &@SUB 
CoE EHD 
i @ SUB 

Go FRIWT A 
TE RE TURH 


STOP 


Forces the currently running program to stop and returns to the console. 
Program can be restarted by CONT. 


Format STOP 
Parameters | None 


END 


Ends the program. 


Format END 
Parameters | None 


FOR ~ TO ~ STEP 


Repeat the designated number of times ( if STEP has been omitted, it will be treated as STEP1. If 
increase is added and the final value is less than the initial value. the FOR command will be skipped 
and the NEXT and subsequent commands will be run.) 


Format FOR variable = initial value TO final value [STEP increase] 


Parameters | None 
The example of use (P48 SAMPLE@, etc) 


Appendix 3 Commands List 


HE wT 
End of FOR 


Format NEXT [variable name] 
Parameters | None 


Error FOR command is not used. 


IF ~ THEN 


Conditional Judgment. 
The IF command does not work across multiple lines. 


> 
AS) 
U 
oO 
= 
3 
x 
= 
a 


IF condition is met THEN command 
IF condition is met THEN @label 


Format 


Parameters | None 


SAMPLE PROGRAM 


Ge IF A==5 THEN PRINT " A==5" : GOTO @1 <+VariableAis5 
EF PRINT " A!=5" Variable A isn't 5 
COEER @ 1 


The example of use (P47 SAMPLE2, etc) 


IF ~ GOTO 
Conditional Judgment. 
The IF command does not work across multiple lines. 


Format IF condition met GOTO @label 
Parameters | None 


REAL 


Reads DATA. 

READ obtained variable1 [, obtained variable2...] 
READ A 

READ B$ 

READ X.Y,Z,G$ 


Variable storing information taken from DATA.Multiple designation 
possible. 
Error Read When amount of data to be read is insufficient. 


Parameters | Obtained variable 


The example of use (P48 SAMPLE3,P61 EXAMPLE 3-10) 
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DATA 
Definition of data to be read with READ command can include a mix of alphanumeric characters. 


DATA number, number 


Format DATA "String","String" 


DATA 128,"SAMPLE" 


Parameters | Data(alohanumeric characters) | Sequences of strings and numbers to be divided with '\' 
The example of use (P48 SAMPLE3,P61 EXAMPLE 3-10) 


RESTORE 
Changes position of DATA to be READ. 


Format RESTORE @label 
Parameters | None 


The example of use (P61 EXAMPLE 8-10) 


THREADS 3 


Convert time string into number. 


MREAD( “time string” ), HOUR, MIN, SEC 


Time string H:MM:SS Format of time string 


HOUR Variable retrieving hour 


Parameters 5 ae : 
MIN Variable retrieving minute 


SEC Variable retrieving second 


SAMPLE PROGRAM 


Ti TNREAD ¢TINE#> , H, MH, S*-H <=—hour, M <== minute, S <== second 


DTREADS 3 
Converts the date string into a number. 


DTREAD( “date string” ), YEAR, MON, DAY 
Date string Date displayed in format: YYYY/MM/DD 


YEAR Variable retrieving year 


Parameters 5 a 
MON Variable retrieving month 


DAY Variable retrieving day 


SAMPLE PROGRAM 


Te DTREAD ©DATE#=2 , ¥, 4M, b«Y <— year, M<—= month, D <—=day 
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3 Basic Console CLS, COLOR, LOCATE, PRINT, CHKCHR(), 
Commands BUTTON(), INKEYS(). INPUT, LINPUT 


Displays characters on the console. 


CLS 
Erases the contents of the console screen. 
Format CLS 


Parameters | None 
The example of use (P54 EXAMPLE 3-01,P58 EXAMPLE 3-06,etc) 


> 
AS) 
U 

oO 

= 

3 
x 

= 
a) 


COLOR 


Caractor coler is specified on console display. 


Format Color Palette number 


O~15 (Uses the 15th color of the 16 color palette 
assigned to BG screens) 


Parameters | Palette number 


SAMPLE PROGRAM:Change the Text Color "COLOR". 


Te FOR T=8 TO 15 «Variable |: 0-15 
ie COLOR I + Set the palette number variable |. 
TEER FRIWT "COLOR"; 1  <+Display "COLOR" by palette number "I". 
TF HE #T 

LOCATE 


Designates the position of the character display on the console. 


Format LOCATE x coordinate, y coordinate 
x coordinate | x coordinate(O-31) * Out of useful range is not error 


Parameters - - , 
y coordinate | y coordinate(O-23) * Out of useful range is not error 


The example of use (P46 SAMPLE1,P54 EXAMPLE 3-01,etc) 


PRINT 


Displays characters on the console. 


"string" 

T variable 

Format T variable$ 

T variable;variable$;’string” 
T "string" variable,variable $ 


Used when displaying multiple elements one after the other. 


Parameters 


When displaying multiple elements one after the other, adjustments are made for TAB position. 


The example of use (P46 SAMPLE1,P76 A Smart Approach to Programming,etc) 
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CHECHE¢ 3 


Search for character numbers on the console. 


Format Variable = CHKCHR (x coordinate, y coordinate) 


x coordinate | x coordinate(O-31) % Out of useful range is not error 


Parameters : : = 
y coordinate | y coordinate(O-23) * Out of useful range is not error 


Returns 0-255=character code(-1= outside range) 


The example of use (P70 Single-Screen Programming Corner @,etc) 


EXMPLE:Display "A" and get its character code. 


Ti LOCATE 15,11:PRINT "aA" Display "A" on the coordinate. 
EH PRIHT CHECHR¢15,113 + Display character code on the coordinate. 


BUTTONS 3 


This returns data from each button pressed. 
Retrieves bitwise data on buttons being pressed simultaneously. For example, if up and right are pressed at the same time, it will return a 
value of 9. 


Format Variable=BUTTON() 


Parameters | None 
Number that corresponds to button. 


Up on +Control Pad 
Down on +Control Pad 
Left on +Control Pad 
Right on +Control Pad 


A Button 
Returns B Button 


X Button 
Y Button 
L Button 
R Button 
START 

SELECT 


The example of use (P55 EXMPLE 38-03,etc) 


EXAMPLE:Display "UP" Up on +Control Pad is pressed. 


Ge IF “<BUTTON®> AND 13==1 THEN PRINT "UP" 
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IHEEY#¢ 3 

Obtains a single character inputted on the keyboard. 

When there is nothing inputted, it will return "". 
Format VariableS=INKEY $0 


Parameters | None 
Returns Character variable A single Keyboard character will be returned. 


The example of use (P56 EXMPLE 3-04,etc) 


> 
EXAMPLE : Wait till the keyboard touched. aS 
i 21 x 
TER IF INKEY# ¢3 ==" "  THEH GOTO #1 bel 
IHPUT 


Obtain numbers or strings. 
Wait for input by keyboard and put what is input into vaiable. 


INPUT ""string""; received variable 


INPUT ""string"'; received character variable$ 
INPUT ""string""; received variable, received character variable$ 
String Explanatory text for entry(Can Be Omitted). 
; : Text string variable or value for obtaining data entered on the 
Received variable 
Parameters eyboard. 
Use commas to split up commands, so you can enter multiple 
commands. 


EXAMPLE:Display the inputted character; 


Ti INPUT A <+Store what is inputted into variable A$. 
PEF FR IWT A  <Display the content of variable A$. 


The example of use (P47 SAMPLE2, P54 EXMPLE 3-02,etc) 


LINPUT 
Retrieves string, including characters like ',| which cannot be entered via INPUT. 


Format LINPUT ['string":] received variable 
String Explanatory text for entry(Can Be Omitted) 
Received variable | Variable for receiving a one line string entered via keyboard. 


Parameters 
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Hd File & 
Communication Commands 


LOAD, SAVE, DELETE, EXEC, RENAME, 
RECVFILE, SENDFILE 


The following commands are used for operations relating to files, such as loading, saving and 


deleting. 


LOAD 


Loads file. 


LOAD "resource name:file name" [ , display control ] 


Parameters 


Resource Name. Strings assigned to the resources to be read. 


PRG 


Program (Can be omitted) 


MEM 


Memory 


COLO~COL2 


color (O=BG, 1=SPRITE, 2=GRP) 


GRPO~GRP 1 


Graphics (O=upper, 1=lower) 


SCUO~SCU1 


User Screen(O=Foreground layer 1=Background layer) 


BGUO~BGU3 


User's BG Characters 


SPUO~SPU7 


User Sprite Characters 


Display control 


Enter FALSE and the dialog box will not be displayed during loading. 


SAVE 


RESULT 


FALSE TRUE CANCEL 


This saves a file. (A dialog box confirming the decision will appear.) 


Format 


SAVE "Resource name:file name" 


Parameters 


Resource name 


*Refer to LOAD 


Error 


DELETE 


RESULT 


FALSE 
TRUE 
CANCEL 


Erases file. (A dialog box confirming the decision will appear.) 


Format 


DELETE "Resource name:file name" 


Parameters 


Resource name 


*Refer to LOAD 


Error 


RESULT 


FALSE 
TRUE 
CANCEL 
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ESEC 


Loads and runs other programs from within the current program. 


Format EXEC "file name" 
Parameters | File name Name of program file to run 
Error RESULT FALSE = Failure 


REHANE 
Changes file names. 


Format RENAME "resource name: file name", "new name" 
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Parameters | Resource name *Refer to LOAD 
FALS 
Error RESULT TRUE 

CANCEL 


RECVFILE 


Receive a Petit Computer file another user has saved on their Nintendo DSi system (displays 
confirmation message). 


Format RECVFILE "resource name: file name" 
Parameters | Resource name *Refer to LOAD 
FALSE 
Error RESULT TRUE 
CANCEL 


The example of use (P62 Exchanging Files With Other DSi and 3DS Users) 


SENDFILE 


Send files to another user who has a Nintendo DSi with Petit Computer saved on it (displays 
confirmation message). 


Format SENDFILE "resource file: file name" 
Parameters | Resource name *Refer to LOAD 
FALSE 
Error RESULT TRUE 
CANCEL 


The example of use (P62 Exchanging Files With Other DSi and 3DS Users) 
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4& Drawing WMISIBIIE, COLINIT. GOLSEl, COLRIEND)., CRIRINIT, 
Commands CHRSET, CHRREAD() 
Display,Draw,Color,Character,etc - - - Commands for visible or seeing. 
VISIBLE 


Control of screen display elements (using O will cause a particular element not to be displayed, while 
using 1 will display it). 


Format VISIBLE console, panel, BGO, BG1, SPRITE, graphic 

Console O=OFF, 1=ON 

Panel O=OFF, 1=ON 

BGO O=OFF, 1=ON 

BG1 O=OFF, 1=ON 

Sprite O=OFF, 1=ON 

Graphic O=OFF, 1=ON 

The example of use (P49 Resetting Memory and Screen,P85 EXAMPLE 4-04,etc) 


Parameters 


COLINIT 


Restores the initial color. 


Format COLINIT "color bank name", color number 


Color bank name 
Strings designating target: 


BG screens 


Parameters Sprites 
Graphics 


Color number |0~255 


COLSET 


Assign new color 
BG number O is the background color 


Format COLSET "color bank name", color number, "color data string” 
Color bank name *Refer to COLINIT 
Color number *Refer to COLINIT 

Parameters 


d In hexadecimal (base 16) notation(the order is RRGGBB) 
Color data string 


Each element will be OO~FF(e.g.)'"FFOOAA™ 


EXAMPLE:Change BG Screen color number O. 


Ge COLSET "BG", 4, "S8S8FF" 
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COLREADS 3 


Retrieves designated color data. Each element 0~255 


COLREAD( "color bank name", color 
number ), R, G, B 

Color bank name | *Refer to COLINIT 
Color number *Refer to COLINIT 


EXAMPLE:Display sprite color number 10. 


Parameters Variable for red Tie COLRFEADC"SP",189,F,6, 6 
Variable for green TE FRIWHT F,6,6 
Variable for blue 
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CHRINIT 


Resets designated character to initial state. 


Format CHRINIT "character name" 


Character name. Strings designating character: 


Parameters BGU0O~BGU3 User BG character 
SPUO~ SPU7 User sprite character 


CHESET 
Define a single character (8x8 pixel units) 


Format CHRSET “character name”, character number, “graphic string” 

Character name __ | *Refer to CHRINIT 

Character number | O~255 

16 color 8x8 pixel character data is expressed in 
Parameters hexadecimal (base 16) notation 

Graphic string (EXAMPLE) "AABBCCDD11223344AABBCCDD1 1223344A 
ABBCCDD1 12238344AABBCCDD1 1223344" 

(each character expresses 1 pixel) 


CHRREALGSE 3 
Retrieves data for the designated character. 
Format CHRREAD( "character name", character name ), C$ 
Character name *Refer to CHRINIT 
Parameters Character number | *Refer to CHRSET 
C$ Variable for graphic string “Refer to CHRSET 


The example of use (P23 EXAMPLE 3-04,etc) 
EXAMPLE:Get the deta of BGUO number 1 character. 


CHRREADC"BGUGB",15,C3 
TF PRINT C# 
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46 Sprite Commands SPPAGE, SPSET, SPCLR, SPOFS, SPCHR, 
SPANIM, SPANGLE, SPSCALE, SPCHK() 


The following commands allow you to perform actions such as starting and pausing sprite movement: 


SPPAGE 


Designates the screen to be used for sprites.Although the lower screen can be selected, it is 
generally used for the keyboard. User characters cannot be displayed on this screen, and only the 
simple graphics already pre-loaded can be used.(Sprite characters of lower screen are on page 14) 
Format SPPAGE screen 

Parameters | Screen O=Upper Screen 1=Lower Screen 

The example of use (P49 Resetting Memory and Screen,P83 EXAMPLE 4-02,etc) 


SPSET 


Sprite definition (activation).Activates a sprite designated by a control number. The coordinates 
are reset to 0,0. Once a sprite has been activated using SPSET and you wish only to change the 
character number, use the SPRCHR command. 

SPSET control number, character number, palette number, horizontal rotation, vertical 
rotation, order of precedence 

Control number 0~99 

Sprite character number |O~511 (for display on lower screen O~117) 

Palette number O~15 


horizontal rotation |O=Nonef 1=Horizontal rotation fl [Horizontal rotation=1, 
vertical rotation O=Nonef 1=Vertical rotation 4 Vertical rotation=1 El 


The order of priority for sprite display is determined by the control 
number: the sprite with the lower number will be displayed further 
forward. 


Parameters 


In front of console 


OR et HRY In front of BG (front layer) 


Between 2 BG layers 
Behind rear BG layer 


The example of use (P81 EXAMPLE 4-01,etc) 


EXAMPLE:Assign the sprite whose character number is 0 and palette number is 2 to control number 0 


Te SPSET &, 8, 2, &, &, a 


SPCLRE 

Erase sprite (Prevent sprites being activated) 

Format SPCLR control number 

Parameters | Control number 0~99 (if omitted, all sprites will be erased) 


The example of use (P49 Resetting Memory and Screen,P83 EXAMPLE 4-02,etc) 


SPOFS 


Changes sprite coordinates. 
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Format SPOFS control number, x coordinate, y coordinate {,interpolation time] 


Control number 


O0~99 


x coordinate -1024~+1024(Out of useful range is not error) 


Parameters | y coordinate -1024~+1024(Out of useful range is not error) 


Interpolation time 


The example of use (P81 EXAMPLE 4-01,etc) 


EXAMPLE:Move the sprite whose control number is 0 to the set coordinate. 


Time taken to automatically add interpolation between 
current state and new value. (1=1/60th sec) 
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Ge SPSET &,4, 2,48, 4,4 
GT SPOFS @, 255, 4, 68 


SPCHR 


Changes the sprite character number. 


SPCHR control number, character number [, palette number, horizontal rotation, vertical 
rotation, order of precedence ] 


Control number 


O0~99 


Sprite character number O~511 (for display on lower screen O~1 17) 


Palette number 


O~15 


Parameters ; : 
horizontal rotation 


O=none, 1=rotate 


vertical rotation 


O=none, 1=rotate 


Order of precedence 


SPANIN 


O~8 


Displays sprite animation. Starting with the current designated character number, using this command 
will make the character number change at defined intervals, It will change within the range of the 


designated number of frames. 


Format SPANIM control numb 


er, number of frames, time [, loop] 


Control number 


O~99 


Number of frames 


1~ 


Parameters : 
Time 


Time to display 1 frame (1=1/60th sec) 


Loop 


O=Endless loop, 1~ (Loop number) 


The example of use (P81 EXAMPLE 4-01,P83 EXAMPLE 4-02) 
EXAMPLE:Animate the sprite set by SPSET. 


Te SPSET 8, 6d, 2, G, G, 
EF SPANHIN &,4,14 


a 
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SPANGLE 


This is used to modify the angle of sprites. From the initial position, the start point for rotation will be 
at the top left of the sprite. Sprite number O~31 cab be used. 


SPANGLE control number, angle [, interpolation time, change direction ] 


Control number O~31 


Angle O~860 (Values outside valid range may be used) 


Time taken to automatically add interpolation between current state and 


Parameters | Interpolation time 
p new value. (1=1/60th sec) 


1=Clockwise -1=Anticlockwise 
(if omitted, will be clockwise) 


The example of use (P83 EXAMPLE 4-02) 


Change direction 


EXAMPLE:Modify the angle of sprite with control number 0. 


Ge SPSET 8, 64, 2,4, 4, @ 
GE SPANHGLE 8,45, 64, 1 


SPSCALE 
Changes the scaling of sprites. Sprite number O~31 cab be used. 


Format SPSCALE control number, scale [, interpolation time ] 


Control number O~31 


Scale O~200 (proportion in percent) 


Parameters : ; ; ; 
Time taken to automatically add interpolation between current state and 


new value. (1=1/60th sec) 
The example of use (P83 EXAMPLE 4-02) 


Interpolation time 


SPCHE¢ 3 


Automatically retrieves interpolation data. 


Format Variable = SPCHK( control number) 


Parameters | Control number 0~99 


FALSE=Interpolation is finished. 
TRUE= Interpolation is in progress. 


Returns State 


EXAMPLE:Change the scaling of sprites continuously. 


Tie SPSET 8,64, 7, 4, 4, & 

TTF SPSCALE 8, 268, 66 «Change the scale of sprite with control number O to 200%. 
EOGER @ 1 

Ge IF SPCHE ¢@) ==TRUE THEN GOTO #1 +Wait for interpolation 
Tt SPSCALE @, 58, 64 +Change to 50% 
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HT BG Screen BGPAGE, BGCLIP, BGOFS. BGPUT, BGREAD() 
Commands 


The following commands allow you to perform tasks such as designating the BG screen to be 
controlled, altering display offsets and writing onto assigned BG screen positions: 


BGOFAGE 

Designates the BG screen to be controlled. > 

Format BGPAGE screen 8 

Parameters | Screen O=Upper Screen 1=Lower Screen x 
oa) 


The example of use (P84 EXAMPLE 4-03) 


BECLIP 


Assigns display parameters (for all layers). 


Format BGCLIP x start point , y start point, x end point, y end point 


x start point O~31 
y start point 0~23 
x end point 0~31 
y end point 0~23 


The example of use (P84 EXAMPLE 4-03) 


Parameters 


BGOFS 
Alters offset of BG screen display. - - - 


BGOFS layer, x coordinate, y coordinate [ , interpolation time ] 


Layer O=Foreground 1=Rear 


x coordinate x coordinate(O-51 1) Out of useful range is not error 
Parameters | y coordinate y coordinate(O-51 1) Out of useful range is not error 
Time taken to automatically add interpolation between 
current state and new value. (1=1/60th sec) 


The example of use (P84 EXAMPLE 4-03) 


Interpolation time 
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BEPUT 


Writes onto designated location on BG screens. 


BGPUT layer. x coordinate, y coordinate, character number, palette 
number, horizontal rotation, vertical rotation 

Layer O=front 1=back 

x coordinate x coordinate(O-63) * Out of useful range is not error 


y coordinate y coordinate(O-63) * Out of useful range is not error 


Parameters | Character number |O0~1023 


Palette number O~15 


horizontal rotation | O=None,1=rotation 


vertical rotation O=None, 1=rotation 
The example of use (P84 EXAMPLE 4-03) 


BGREADS 3 
Obtains data from designated location on BG screens. 


BGREAD( layer, x coordinate, y coordinate ), CHR, PAL, H, V 

Layer O=Foreground, 1=Rear 

x coordinate x coordinate(O-63) * Out of useful range is not error 
y coordinate y coordinate(O-63) * Out of useful range is not error 


Parameters | CHR Variable for character number 


Variable for palette number 


Variable for horizontal rotation 


Variable for horizontal rotation 


The example of use (P69 Single-Screen Programming @) 
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4 & Graphic Commands GPAGE, GCOLOR, GCLS, GSPOIT(), 
GPSET, GPAINT, GLINE, GBOX, GFILL. 
GCIRCLE, GPUTCHR 


The following commands perform tasks such as designating the graphic page,erasing 
graphics,etc. 


GPAGE = 
Designates the graphic screen to be used. a. 
Format GPAGE screen 3 
Parameters | Screen O=Upper Screen 1=Lower Screen 


The example of use (P49 Resetting Memory and Screen,P57 EXAMPLE 3-05) 


GCOLOR 
Assigns graphic color on graphic screen. 
Format GCOLOR color number 
Parameters = Color number O~255 
GOLS 
Erases images on designated graphic screen. 
Format GCLS [ color ] 
Parameters — Color O~255(To use color of GCOLOR when it is abbreviated. ) 


The example of use (P49 Resetting Memory and Screen,P58 EXAMPLE 3-06) 


GSPOIT¢ 3 
Checks color of designated location. 


Format Variable=GSPOIT (x coordinate, y coordinate) 


x coordinate O~ 255 (Out of useful range is not error) 


Parameters - - 
y coordinate O~191 (Out of useful range is not error) 


Returns Color O~255 (-1 if outside range) 
The example of use (P57 EXAMPLE 3-05) 
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GPSET 
Adds a dot. 


Format 


GPSET x coordinate, y coordinate [ ,color ] 


Parameters 


x coordinate 


O~ 255 (Out of useful range is not error) 


y coordinate 


O~191 (Out of useful range is not error) 


Color 


O~255(To use color of GCOLOR when it is abbreviated. ) 


The example of use (P57 EXAMPLE 3-05,P58 EXAMPLE 3-06) 


GPAINT 


Fills in color from designated point. To save time, any color adjacent to the designated location which 


has the same color will be filled in. 


Format 


GPAINT x coordinate, y coordinate [ ,color ] 


Parameters 


GLINE 


Draws a line. 


xX coordinate 


O~ 255 (Out of useful range is not error) 


y coordinate 


O~191 (Out of useful range is not error) 


Color 


GLINE x start poin 


O~255(To use color of GCOLOR when it is abbreviated. ) 


, y Start point, x end point, y end point [ ,color ] 


Parameters 


x start point 


O~ 255 (Out of useful range is not error) 


y start point 


O~191 (Out of useful range is not error) 


x end point 


O~ 255 (Out of useful range is not error) 


y end point 


O~191 (Out of useful range is not error) 


Color 


O~255(To use color of GCOLOR when it is abbreviated. ) 


The example of use (P58 EXAMPLE 3-06) 


GEO 


Draws a box. 


GBOX x start poin 


_y Start point, x end point, y end point [ ,color ] 


Parameters 


x start point 


O~ 255 (Out of useful range is not error) 


y start point 


O~191 (Out of useful range is not error) 


x end point 


O~ 255 (Out of useful range is not error) 


y end point 


O~191 (Out of useful range is not error) 


Color 


O~255(To use color of GCOLOR when it is abbreviated. ) 
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GFILL 


Fills in color of a rectangle. 


Format GFILL x start point, y start point, x end point, y end point [ ,color ] 


x start point O~255 (Out of useful range is not error) 


y start point O~191 (Out of useful range is not error) 


Parameters | x end point O~ 255 (Out of useful range is not error) 


y end point O~191 (Out of useful range is not error) 


Color O~255(To use color of GCOLOR when it is abbreviated. ) g 
The example of use (P57 EXAMPLE 3-05) S 
S 
GCIRCLE 
Draws a circle. 
Format GCIRCLE x coordinate, y coordinate, radius [ ,color J [, initial angle, final angle ] 
x coordinate O~255 (Out of useful range is not error) 
y coordinate O~191 (Out of useful range is not error) 
Radius O~ 255 (Out of useful range is not error) 
Parameters a : 
Color O~255(To use color of GCOLOR when it is abbreviated. ) 
Initial angle O~ 860 (Out of useful range is not error) 
Final angle O~860 (Out of useful range is not error) 


The example of use (P58 EXAMPLE 3-06) 


GPUTCHR 


This displays the assigned character graphic data on the graphic screen. 

This command will copy the data for the designated palette number to the graphic palette. The 
assigned location will be colored with the 16th shade of the 16th color from the designated palette 
number. 


Format GPUTCHR x coordinate, y coordinate, "character name", number, palette number, scale 
x coordinate O~255 (Out of useful range is not error) 
y coordinate O~191 (Out of useful range is not error) 
Character name_ | *Refer to CHRINIT 
Parameters 
Number Character number(O~255) 
Palette number Character color(O~15) 
Scale Rate of scaling(1,2,4,8) 


The example of use (P58 EXAMPLE 3-06) 


EXAMPLE : Display BGUO character on the center of screen. 


Ge GPUTCHR 128,96, " BGUG" ,16,2,1 
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fH ‘4 Audio Commands BEEP, BGMPLAY, BGMSTOP, BGMCHK\() 


The following commands relate to playing sound effects and background music. 


BEEP 


Plays a simple warning sound effect. 


BEEP [ waveform number [,pitch [,volume [,panpot]]]] 


Waveform number O~69 (if omitted, number is O) 

-8192 plays sound 2 octaves lower, O is the original Sound, 8192 plays 
Pitch it 2 octaves higher. 

Parameters C=PxO FH=Px6 C#=Px1 G=Px/7 D=Px2 G#=Px8 D#= 
Px3 A=PxX9 E=Px4 A#=Px10 F=Px5 B=Px11 

Volume O=No sound 127=Maximum 


Panpot O=from left 64=from center 127=from right 
The example of use (P61 EXAMPLE 3-09,EXAMPLE 3-10,etc) 


Waveform number 


Beep Synth Brass 36 AUTO Dance HH 
Noise Synth Bass 37 | SHOCK Hit 

Cursor Movement Guitar 38 | ESC Timpani 
Confirm Organ 39 Banjo 2 Chinese Cymbal 
Cancel Piano 40 Scratching Mini Cymbal 


Ascend Cow Bell 41 Guitar 2 Shaker 


Descend Tom-Toms 42 | Organ 2 Bell 


Coin Cymbals 43 | Piano 2 Japanese Drum 
Jump Open High-Hat 44 | PASS Synthesizer 
Land Closed High-Hat 45 | UP2 Canorus 

Fire Handclap 46 Record Puff! 


Damage Rimshot 47 | Synth Tom-Toms ohkan 


etal Snare Drum 48 Cow Bell 2 Humanar 1 


Explosion Bass Drum 49 metro Humandr2 
Scream OK2 50 tri Dog 
Brake BALL 51 Conga Cat 
Banjo Japan Style 52 Dance BD 
Synth Strings VOLT 53 Dance SD 
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BGNPLAY 
Starts playing song. Can play only song in the software. 


Format BGMPLAY [track number, ] song number [ , track volume ] 


Parameters | Song number O~29 
The example of use (P60 EXAMPLE 3-08) 


Song number 30 songs (O~ 29) 


Jolly and Jaunty Staff List 2 BAL_2 


Dark and Dank Classical Drama Espionage 


tu xipueddy 


Tension is Rising Marching Band SCI 

Upbeat Emotion Ultra-hard Rock Shooting Song 
Opening Jingle Jolly and Jaunty 2 Pad 

Clear Jingle WOND SEN 

Game Over Deep in Thought Pure 

Menu Select WOND2 ROA 

Result Screen For the Future CUR 

Staff List BAL FIG 


BENSTOP 


Stops playing song. 


The example of use (P49 Clear memory,etc) 


BONCHEK € 3 
This lets you check on current music status. 
Format Variable=BGMCHK() 
Returns FALSE=Music stopped =TRUE=Music playing 
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1 Panel & Icon 
Commands 


The following commands let you perform tasks like changing panel type, and checking user 


PNLTYPE, PNLSTR, ICONSET, ICONCLR, ICONCHK() 


system icon status or adjusting their settings. 


PHLTYPE 
Changes the panel type. 
PNLTYPE "panel name" 


Panel name. Strings that select type to be displayed on Lower 
Screen: 


No panel is displayed 
When there is no keyboard 


Parameters 
English keyboard 


Symbol keyboard 


Kana keyboard 


The example of use (P57 EXAMPLE 8-05,etc) 


PHLSTR 


String Display on Lower Screen. Line breaks will not be added automatically, even when displaying 
the last line. 


Format PNLSTR x coordinate, y coordinate, "string", palette number 
x coordinate x coordinate(O-31) 3 Out of useful range is not error 
y coordinate y coordinate(O-23) *« Out of useful range is not error 
Parameters - ; : ; 
String String you wish to be displayed 
Palette number O~15 


The example of use (P71 Single-Screen Programming Corner,etc) 


ICONSET 


Settings for user system icon characters (or to initiate display). 


Format ICONSET icon position, icon number 


Icon position User System Icon Number(O~3) 


Parameters 


Icon number Icon Character Control Number(O~63) 


ICOHCLE 

Cancels display of user system icons. 

Format ICONCLR icon position 

Parameters | Icon position User System Icon Number(O~3) 


ICONCHE © 3 


Check current status of user system icons. 


Format 
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Number=ICONCHK() 


Parameters 


None 


Returns 


Number 


-1=not pressed 
O~8 (icon location), 
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11 Text commands ASC(), CHRS(), VAL(. STR&(). HEX$(). MIDS). LEN( 


Character string,character code,etc Character commands. 


ASC¢sS 


Character code of designated character 


Format 


Variable=ASC( character ) 


Parameters 


None 


Returns 


Number 


Character code of designated character 


The example of use (P56 EXAMPLE 3-04,P64 Single-Screen Programming Corner,etc) 


CHR 3 


Returns the character for the designated ASCII code. 


Format 


Variable$ = CHR§$( character code ) 


Parameters 


Character code 


Number ascribed to each character 


Returns 


Character 


Number ascribed to each character 


The example of use (P54 EXAMPLE 3-01,P86 EXAMPLE 4-04,etc) 


VAL C3 


Obtains a number from a string. 


Format 


Variable = VAL( string ) 


Parameters 


String 


String with number 


Returns 


The example of use (P56 EXAMPLE 3-04,etc) 


Number 


Number extracted from string 
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STR#C 3 


Obtain a string from a number. 


Format 


Variable$=STR&( number ) 


Parameters 


Number 


Number you want to convert to string 


Returns 


HEC 3 


Character 


String generated from number 


Gives a hexadecimal string from a number. 


Format 


Variable$ = H 


EX$ (numerical value [, decimal places]) 


Parameters 


Number 


Number you want to convert to hexadecimal string 


Returns 


MIDFC a 


Character 


Hexadecimal string generated from number 


Extracts a string of a designated length starting from the initial position within the target string. 


Format 


Variable$ = MID§( string, initial position, number of characters ) 


Parameters 


String 


Original string 


Initial position 


Initial position of characters(The top of character position is O) 


Number of characters 


Number of characters to be retrieved 


Returns 


Character 


Extracted string 


The example of use (P56 EXAMPLE 3-04,P65 Single-Screen Programming Corner,etc) 


LEN«3 


Obtains the number of characters within a string. 


Format 


Variable = LEN( string ) 


Parameters 


String 


String you want to determine the length of 


Returns 


Number 


Number of characters (every character is 
counted as 1) 
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1% Basic Mathematical FLOOR(), RND(), ABS(), SGN(), SQR(), EXP(), LOG(), 
Functions PI(), RAD(), DEG(), SINQ, COS(Q, TAN(, ATAN() 


The following mathematical functions allow you to perform tasks including obtaining integers, 
absolute values, codes and generating random numbers. 


FLOORS > 


Obtain the integer or whole number. 
You can also use the AND command to obtain an integer in a 1 byte range (e.g.) A=A AND &HFF 


Format Variable = FLOOR( number ) 
Parameters | Number Number 
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Returns Number Requested result 
The example of use (P54 EXAMPLE 3-01,P84 EXMPLE 4-03.etc) 


RHO? 3 
Gives a random number up to the designated value. 


Format Variable = RND ( maximum number ) 


Parameters | Maximum value | Maximum number generated 


Random number from O~maximum number (not 
including the maximum value) 


The example of use (P81 EXAMPLE 4-01,P82 A Program with a 50% Probability) 


Returns Number 


ABS 3 
Obtains an absolute value. 


Format Variable = ABS ( number ) 


Number from which you want to obtain an 


Parameters | Number 
absolute value 


Returns Number Absolute value 


SGN¢ 3 
Obtains a code. 


Format Variable = SGN ( variable ) 


Parameters | Number Number to check code 


Returns Number Oor +1 
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SQR C3 


Obtains the square root of a number. 


Format Variable = SQR( number ) 


Parameters | Number Original numerical value 
Returns Number Requested result 


ExePea 
Looks for the exponent value. 


Format Variable = EXP( number ) 


Parameters | Number Original numerical value 
Returns Number Requested result 


LOG 3 
AAMTWE RDS. 


Format Variable = LOG( variable ) 


Parameters | Number Original numerical value 


Returns Number Requested result 


FI¢3 

Obtains value of pi(circumference ratio). 

Format Variable = PI() 

Returns Number Value of pi (circumference ratio) 
RAD 3 


Obtain a radian figure from angle data. 


Format Variable = RAD( angle ) 


Parameters | Angle O~ 360 
Returns Number Radian figure from angle 


DEG¢3 
Obtains angle data from radian value. 


Format Variable = DEG( radian ) 


Parameters | Radian O~2r 
Returns Number Angle from radian value 
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SINGs 


Returns sine value. 


Format Variable = SIN( radian ) 


Parameters | Radian | Radian value of angle 


Returns Number Requested result 
The example of use (P83 EXAMPLE 4-02) 


coses 


Returns cosine value. 
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Format Variable = COS( radian ) 
Parameters | Radian Radian value of angle 


Returns Number Requested result 
The example of use (P83 EXAMPLE 4-02) 


TANS 3 
Returns tangent value. 


Format Variable = TAN( radian ) 


Parameters | Radian Radian value of angle 


Returns Number Requested result 


ATANH® 3 


Obtains the arc tangent value. 

<color rgob5=1f0000>Can also be used as a function for determining direction from 2 parameters ( 
Y, X ) and displacement. Desired direction=ATAN( destination y-y, destination x-x )</color> 

Format Variable = ATAN( radian ) 

Parameters | Radian Radian value of angle 


Returns Number Requested result 


The example of use (P44 GAMES3-Advice of improvement) 
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Afterword 


Takuya Matsubara 


My name is Takuya Matsuhara and | am responsible for writing the main sections of this 
guide.As a huge fan of Petit Computer, | am delighted to have had the opportunity to be involved 
in this publication, and to see it come to fruition. 

It should be obvious, even from a cursory glance at the contents page, that this is more 
than a simple instruction manual or strategy guide. | hope my passion for the golden age of 
BASIC is evident throughout this guide. In truth, | would have liked even more space to explore 
the history of BASIC... | am incredibly happy that ASCII Media Works chose to publish this guide, 
in spite of any concern that its contents would limit it to a very specialist readership. 

A company called Jolls were responsible for editing this guide. Editing work entails 
everything from page layout to correcting the text and coming up with the design. But this guide 
presented particular challenges, involving a great deal of checking DSi screens, and entering 
data from the computer monitor into the DSi. 

| have worked with Jolls before, collaborating on the programming section of My Con BASIC 
Magazine, and | was very happy to join forces with them once again. It really does feel like 
BASIC programming has been reborn. 

| was very lucky to have received the generous support of SmileBoom, the company behind 
Petit Computer, and am grateful for the material they provided, as well as for the opportunity 
to interview the company president. The comic characters who appeared throughout this guide 
originally appeared on the official Petit Computer website. 

| was also fortunate enough to be permitted to use the official name of the game in the title. 
What's more, a number of legendary figures from the world of BASIC programming were kind 
enough to contribute to this guide. Readers who remember that era are bound to be impressed 
by the line up of names who have been interviewed. | have received support from a large 
number of people in preparing the images and programs used throughout. | would like to take 
this opportunity to thank everyone who was involved in the creation of this guide. 

Nothing would make me happier than to think that this guide will inspire people to get ever 
more our of Petit Computer. 


A Final Bonus Program 


Te ASS" TOFFEE FTO" 

Me FOR I=6 TO 49 

HEP C=ASCCNIDSC AS, I, 193 
GMP PRINT CHR#¢C+13; 
CODE® ME eT 


(Jun 201 1) 


Further Reading 


Official Website 

This is SmileBoom's official Petit Computer website, introducing users to a new take on BASIC programming. 
There's a lot of content to explore, including programs contributed by fans of the software, and lessons for 
beginners. 


http://smileboom.com/special/petitcom/ 


Official Petit Computer Twitter Account 


htto://twitter.com/PetitComputer 
Petit Computer Wiki Compilation 
All the Petit Computer info you could hope for, lovingly compiled by fans. It features bug reports and smart 
programming tips. 
http://wiki.hosiken.jp/petc/ 


Petit Computer Wiki 
Another informative site compiled by fans. 


htto://www46.atwiki.jp/petitcom/ 


More About this Guide Available Online 


Any corrections or FAQs relating to this guide will be made available at this URL: 
http://ascii.asciimw.jp/books/books/detail/978-4-04-87067 1-1.shtml 


Copyright 


NINTENDODP)S - =v FVR-DSISERZORERERTCT. 
Trademarks registered in Japan. 


3 Nintendo 3DS and its logo are the property of Nintendo. 

3 Microsoft Windows is an internationally registered trademark belonging to Microsoft Corporation. 
*« Petit Computer is a trademark registered by SmileBoom Co, Ltd. 

%K All other product names used in this guide are registered trademarks. 

3x TM, ® and © symbols have been omitted from this guide. 


Disclaimers 


%* The texture and color of screenshot images featured in this book vary depending on the device the program is running 
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% Prior to publication, this book was carefully checked for any errors, but its accuracy cannot be guaranteed. If any 
programs featured in it produce syntax errors, please check that the program code has been entered correctly. 
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